自动化
自动化由一个或多个操作组成,如果在一段时间后满足某些条件,则执行这些操作。情况每小时检查一次。例如,当一个票证在24小时后仍未解决时,自动化可以通知代理。
即使执行了一次操作,如果条件仍然适用,以后也会再次执行这些操作。要确保操作只执行一次,请在自动化中包含取消其中一个条件的操作。
有关更多信息,请参见为基于时间的事件创建和管理自动化.
JSON格式
自动化被表示为具有以下属性的JSON对象:
名字 | 类型 | 只读 | 强制性的 | 描述 |
---|---|---|---|---|
行动 | 数组 | 假 | 假 | 描述自动化将做什么的对象。看到操作参考 |
活跃的 | 布尔 | 假 | 假 | 自动化是否激活 |
条件 | 对象 | 假 | 假 | 描述执行自动化的条件的对象。看到参考条件 |
created_at | 字符串 | 真正的 | 假 | 创建自动化的时间 |
默认的 | 布尔 | 真正的 | 假 | 如果为true,则该自动化是默认的自动化 |
id | 整数 | 真正的 | 假 | 创建时自动分配 |
位置 | 整数 | 假 | 假 | 指定执行顺序的自动化操作的位置 |
raw_title | 字符串 | 真正的 | 假 | 自动化的原始标题 |
标题 | 字符串 | 假 | 假 | 自动化的标题 |
updated_at | 字符串 | 真正的 | 假 | 自动化最后一次更新的时间 |
例子
{
“行动”:[
{
“字段”:“优先”,
“价值”:“高”
}
],
“活跃”:真正的,
“条件”:{
“所有”:[
{
“字段”:“状态”,
“运营商”:“是”,
“价值”:“开放”
},
{
“字段”:“优先”,
“运营商”:“less_than”,
“价值”:“高”
}
],
“任何”:[]
},
“默认”:假,
“id”:9873843,
“位置”:8,
“raw_title”:“罗杰照办”,
“标题”:“罗杰照办”
}
列表自动化
GET / api / v2 /自动化
列出当前帐户的所有自动化操作。
允许
- 代理
可用参数
你可以传入以下可选过滤器的任意组合:
名字 | 类型 | 评论 |
---|---|---|
活跃的 | 布尔 | 如果为真,只有活动的自动化,如果为假,只有非活动的自动化 |
sort_by | 字符串 | 取值为“字母顺序”、“created_at”、“updated_at”、“usage_1h”、“usage_24h”或“usage_7d”。默认为"position" |
sort_order | 字符串 | asc或desc中的一个字母和位置排序默认为“asc”,其他所有默认为“desc” |
拷贝的
支持以下副负载。使用侧负载仅支持Support Professional或Suite增长计划或更高版本。
名字 | 将拷贝的 |
---|---|
app_installation | 如果存在,则需要每个自动化的应用程序安装 |
权限 | 每个自动化的权限 |
usage_1h | 每个自动化在过去一小时内被使用的次数 |
usage_24h | 每个自动化在过去一天中被使用的次数 |
usage_7d | 每个自动化在过去一周内被使用的次数 |
usage_30d | 每个自动化在过去30天内被使用的次数 |
分页
- 游标分页(推荐)
- 抵消分页
看到分页.
每页最多返回100条记录。
代码示例
旋度
旋度https://{子域名}.亚博zendesk.com/api/v2/automations.json\
- v - u{电子邮件}:{密码}
去
进口(
“fmt”
“输入输出”
“net/http”
)
函数主要(){
url:=“https://example.亚博zendesk.com/api/v2/automations”
方法:=“获得”
要求的事情,犯错:=http.NewRequest(方法,url,零)
如果犯错! =零{
fmt.Println(犯错)
返回
}
要求的事情.头.添加(“内容类型”,“application / json”)
要求的事情.头.添加(“授权”,“基本< auth-value >”)// Base64编码的"username:password"
客户端:=&http.客户端{}
res,犯错:=客户端.做(要求的事情)
如果犯错! =零{
fmt.Println(犯错)
返回
}
推迟res.身体.关闭()
身体,犯错:=io.ReadAll(res.身体)
如果犯错! =零{
fmt.Println(犯错)
返回
}
fmt.Println(字符串(身体))
}
Java
进口com.squareup.okhttp.*;
OkHttpClient客户端=新OkHttpClient();
HttpUrl.构建器urlBuilder=HttpUrl.解析(“https://example.亚博zendesk.com/api/v2/automations”)
.newBuilder();
请求请求=新请求.构建器()
.url(urlBuilder.构建())
.方法(“获得”,零)
.addHeader(“内容类型”,“application / json”)
.addHeader(“授权”,凭证.基本(“电子邮件”,“你的密码”))
.构建();
响应响应=客户端.newCall(请求).执行();
Nodejs
varaxios=需要(“axios”);
var配置={
方法:“得到”,
url:“https://example.亚博zendesk.com/api/v2/automations”,
头:{
“内容类型”:“application / json”,
“授权”:的基本< auth-value >”,// Base64编码的"username:password"
},
};
axios(配置)
.然后(函数(响应){
控制台.日志(JSON.stringify(响应.数据));
})
.抓(函数(错误){
控制台.日志(错误);
});
Python
进口请求
url=“https://example.亚博zendesk.com/api/v2/automations”
头={
“内容类型”:“application / json”,
}
响应=请求.请求(
“获得”,
url,
身份验证=(“<用户名>”,' <密码> '),
头=头
)
打印(响应.文本)
鲁比(人名)
需要“net/http”
uri=URI(“https://example.亚博zendesk.com/api/v2/automations”)
请求=网::HTTP::得到.新(uri,“内容类型”:“application / json”)
请求.basic_auth“用户名”,“密码”
响应=网::HTTP.开始uri.主机名,uri.港口,use_ssl:真正的做|http|
http.请求(请求)
结束
示例响应(年代)
200好了
//状态200 OK
{
“自动化”:[
{
“行动”:[
{
“字段”:“状态”,
“价值”:“开放”
},
{
“字段”:“assignee_id”,
“价值”:“296220096”
}
],
“活跃”:真正的,
“条件”:{
“所有”:[
{
“字段”:“状态”,
“运营商”:“less_than”,
“价值”:“解决”
},
{
“字段”:“assignee_id”,
“运营商”:“是”,
“价值”:“296220096”
}
],
“任何”:[
{
“字段”:“current_tags”,
“运营商”:“包括”,
“价值”:“你好”
}
]
},
“id”:25,
“位置”:8,
“raw_title”:“关闭并保存”,
“标题”:“关闭并保存”
},
{
“行动”:[
{
“字段”:“状态”,
“价值”:“开放”
},
{
“字段”:“assignee_id”,
“价值”:“296220096”
}
],
“活跃”:假,
“条件”:{
“所有”:[
{
“字段”:“状态”,
“运营商”:“less_than”,
“价值”:“解决”
},
{
“字段”:“assignee_id”,
“运营商”:“是”,
“价值”:“296220096”
}
],
“任何”:[
{
“字段”:“current_tags”,
“运营商”:“包括”,
“价值”:“你好”
}
]
},
“id”:26,
“位置”:9,
“raw_title”:“{{dc.assign_priority_tag}}”,
“标题”:“分配优先级标签”
}
],
“数”:2,
“next_page”:零,
“previous_page”:零
}
列出活动自动化
GET / api / v2 /自动化/活跃
列出所有活动的自动化。
允许
- 代理
可用参数
你可以传入以下可选过滤器的任意组合:
名字 | 类型 | 评论 |
---|---|---|
sort_by | 字符串 | 取值为“字母顺序”、“created_at”、“updated_at”、“usage_1h”、“usage_24h”或“usage_7d”。默认为"position" |
sort_order | 字符串 | asc或desc中的一个字母和位置排序默认为“asc”,其他所有默认为“desc” |
拷贝的
支持以下副加载:
名字 | 将拷贝的 |
---|---|
app_installation | 如果存在,则需要每个自动化的应用程序安装 |
权限 | 每个自动化的权限 |
usage_1h | 每个自动化在过去一小时内被使用的次数 |
usage_24h | 每个自动化在过去一天中被使用的次数 |
usage_7d | 每个自动化在过去一周内被使用的次数 |
usage_30d | 每个自动化在过去30天内被使用的次数 |
代码示例
旋度
旋度https://{子域名}.亚博zendesk.com/api/v2/automations/active.json\
- v - u{电子邮件}:{密码}
去
进口(
“fmt”
“输入输出”
“net/http”
)
函数主要(){
url:=“https://example.亚博zendesk.com/api/v2/automations/active”
方法:=“获得”
要求的事情,犯错:=http.NewRequest(方法,url,零)
如果犯错! =零{
fmt.Println(犯错)
返回
}
要求的事情.头.添加(“内容类型”,“application / json”)
要求的事情.头.添加(“授权”,“基本< auth-value >”)// Base64编码的"username:password"
客户端:=&http.客户端{}
res,犯错:=客户端.做(要求的事情)
如果犯错! =零{
fmt.Println(犯错)
返回
}
推迟res.身体.关闭()
身体,犯错:=io.ReadAll(res.身体)
如果犯错! =零{
fmt.Println(犯错)
返回
}
fmt.Println(字符串(身体))
}
Java
进口com.squareup.okhttp.*;
OkHttpClient客户端=新OkHttpClient();
HttpUrl.构建器urlBuilder=HttpUrl.解析(“https://example.亚博zendesk.com/api/v2/automations/active”)
.newBuilder();
请求请求=新请求.构建器()
.url(urlBuilder.构建())
.方法(“获得”,零)
.addHeader(“内容类型”,“application / json”)
.addHeader(“授权”,凭证.基本(“电子邮件”,“你的密码”))
.构建();
响应响应=客户端.newCall(请求).执行();
Nodejs
varaxios=需要(“axios”);
var配置={
方法:“得到”,
url:“https://example.亚博zendesk.com/api/v2/automations/active”,
头:{
“内容类型”:“application / json”,
“授权”:的基本< auth-value >”,// Base64编码的"username:password"
},
};
axios(配置)
.然后(函数(响应){
控制台.日志(JSON.stringify(响应.数据));
})
.抓(函数(错误){
控制台.日志(错误);
});
Python
进口请求
url=“https://example.亚博zendesk.com/api/v2/automations/active”
头={
“内容类型”:“application / json”,
}
响应=请求.请求(
“获得”,
url,
身份验证=(“<用户名>”,' <密码> '),
头=头
)
打印(响应.文本)
鲁比(人名)
需要“net/http”
uri=URI(“https://example.亚博zendesk.com/api/v2/automations/active”)
请求=网::HTTP::得到.新(uri,“内容类型”:“application / json”)
请求.basic_auth“用户名”,“密码”
响应=网::HTTP.开始uri.主机名,uri.港口,use_ssl:真正的做|http|
http.请求(请求)
结束
示例响应(年代)
200好了
//状态200 OK
{
“自动化”:[
{
“行动”:[
{
“字段”:“状态”,
“价值”:“开放”
},
{
“字段”:“assignee_id”,
“价值”:“296220096”
}
],
“活跃”:真正的,
“条件”:{
“所有”:[
{
“字段”:“状态”,
“运营商”:“less_than”,
“价值”:“解决”
},
{
“字段”:“assignee_id”,
“运营商”:“是”,
“价值”:“296220096”
}
],
“任何”:[
{
“字段”:“current_tags”,
“运营商”:“包括”,
“价值”:“你好”
}
]
},
“id”:25,
“位置”:8,
“raw_title”:“关闭并保存”,
“标题”:“关闭并保存”
},
{
“行动”:[
{
“字段”:“状态”,
“价值”:“开放”
},
{
“字段”:“assignee_id”,
“价值”:“296220096”
}
],
“活跃”:假,
“条件”:{
“所有”:[
{
“字段”:“状态”,
“运营商”:“less_than”,
“价值”:“解决”
},
{
“字段”:“assignee_id”,
“运营商”:“是”,
“价值”:“296220096”
}
],
“任何”:[
{
“字段”:“current_tags”,
“运营商”:“包括”,
“价值”:“你好”
}
]
},
“id”:26,
“位置”:9,
“raw_title”:“{{dc.assign_priority_tag}}”,
“标题”:“分配优先级标签”
}
],
“数”:2,
“next_page”:零,
“previous_page”:零
}
搜索自动化
GET / api / v2 /自动化/搜索?查询查询= {}
分页
- 仅偏移分页
看到使用偏移分页.
允许
- 代理
拷贝的
支持以下副负载。有关更多信息,请参见侧载.
名字 | 将拷贝的 |
---|---|
app_installation | 如果存在,则需要每个自动化的应用程序安装 |
权限 | 每个自动化的权限 |
usage_1h | 每个自动化在过去一小时内被使用的次数 |
usage_24h | 每个自动化在过去一天中被使用的次数 |
usage_7d | 每个自动化在过去一周内被使用的次数 |
usage_30d | 每个自动化在过去30天内被使用的次数 |
参数
名字 | 类型 | 在 | 要求 | 描述 |
---|---|---|---|---|
活跃的 | 布尔 | 查询 | 假 | 如果为真,则按活动自动化过滤;如果为假,则按非活动自动化过滤 |
包括 | 字符串 | 查询 | 假 | 要包含在响应中的副负载。看到拷贝的 |
查询 | 字符串 | 查询 | 真正的 | 用于查找具有匹配标题的所有自动化的查询字符串 |
sort_by | 字符串 | 查询 | 假 | 取值为"alphabetical"、"created_at"、"updated_at"和"position"。如果未指定,则按相关性对自动化进行排序 |
sort_order | 字符串 | 查询 | 假 | asc或desc中的一个字母和位置排序默认为“asc”,其他所有默认为“desc” |
代码示例
旋度
旋度https://{子域名}.亚博zendesk.com/api/v2/automations/search.json ?查询=关闭\
- v - u{电子邮件}:{密码}
去
进口(
“fmt”
“输入输出”
“net/http”
)
函数主要(){
url:=“https://example.亚博zendesk.com/api/v2/automations/search?active=true&include=usage_24h&query=close&sort_by=position&sort_order=desc”
方法:=“获得”
要求的事情,犯错:=http.NewRequest(方法,url,零)
如果犯错! =零{
fmt.Println(犯错)
返回
}
要求的事情.头.添加(“内容类型”,“application / json”)
要求的事情.头.添加(“授权”,“基本< auth-value >”)// Base64编码的"username:password"
客户端:=&http.客户端{}
res,犯错:=客户端.做(要求的事情)
如果犯错! =零{
fmt.Println(犯错)
返回
}
推迟res.身体.关闭()
身体,犯错:=io.ReadAll(res.身体)
如果犯错! =零{
fmt.Println(犯错)
返回
}
fmt.Println(字符串(身体))
}
Java
进口com.squareup.okhttp.*;
OkHttpClient客户端=新OkHttpClient();
HttpUrl.构建器urlBuilder=HttpUrl.解析(“https://example.亚博zendesk.com/api/v2/automations/search”)
.newBuilder()
.addQueryParameter(“活跃”,“真正的”)
.addQueryParameter(“包括”,“usage_24h”)
.addQueryParameter(“查询”,“关闭”)
.addQueryParameter(“sort_by”,“位置”)
.addQueryParameter(“sort_order”,“desc”);
请求请求=新请求.构建器()
.url(urlBuilder.构建())
.方法(“获得”,零)
.addHeader(“内容类型”,“application / json”)
.addHeader(“授权”,凭证.基本(“电子邮件”,“你的密码”))
.构建();
响应响应=客户端.newCall(请求).执行();
Nodejs
varaxios=需要(“axios”);
var配置={
方法:“得到”,
url:“https://example.亚博zendesk.com/api/v2/automations/search”,
头:{
“内容类型”:“application / json”,
“授权”:的基本< auth-value >”,// Base64编码的"username:password"
},
参数个数:{
“活跃”:“真正的”,
“包括”:“usage_24h”,
“查询”:“关闭”,
“sort_by”:“位置”,
“sort_order”:“desc”,
},
};
axios(配置)
.然后(函数(响应){
控制台.日志(JSON.stringify(响应.数据));
})
.抓(函数(错误){
控制台.日志(错误);
});
Python
进口请求
url=“https://example.亚博zendesk.com/api/v2/automations/search?active=true&include=usage_24h&query=close&sort_by=position&sort_order=desc”
头={
“内容类型”:“application / json”,
}
响应=请求.请求(
“获得”,
url,
身份验证=(“<用户名>”,' <密码> '),
头=头
)
打印(响应.文本)
鲁比(人名)
需要“net/http”
uri=URI(“https://example.亚博zendesk.com/api/v2/automations/search”)
uri.查询=URI.encode_www_form(“活跃”:“真正的”,“包括”:“usage_24h”,“查询”:“关闭”,“sort_by”:“位置”,“sort_order”:“desc”)
请求=网::HTTP::得到.新(uri,“内容类型”:“application / json”)
请求.basic_auth“用户名”,“密码”
响应=网::HTTP.开始uri.主机名,uri.港口,use_ssl:真正的做|http|
http.请求(请求)
结束
示例响应(年代)
200好了
//状态200 OK
{
“自动化”:[
{
“行动”:[
{
“字段”:“状态”,
“价值”:“开放”
},
{
“字段”:“assignee_id”,
“价值”:“296220096”
}
],
“活跃”:真正的,
“条件”:{
“所有”:[
{
“字段”:“状态”,
“运营商”:“less_than”,
“价值”:“解决”
},
{
“字段”:“assignee_id”,
“运营商”:“是”,
“价值”:“296220096”
}
],
“任何”:[
{
“字段”:“current_tags”,
“运营商”:“包括”,
“价值”:“你好”
}
]
},
“id”:25,
“位置”:9,
“raw_title”:“关闭并保存”,
“标题”:“关闭并保存”
},
{
“行动”:[
{
“字段”:“状态”,
“价值”:“开放”
},
{
“字段”:“assignee_id”,
“价值”:“296220096”
}
],
“活跃”:真正的,
“条件”:{
“所有”:[
{
“字段”:“状态”,
“运营商”:“less_than”,
“价值”:“解决”
},
{
“字段”:“assignee_id”,
“运营商”:“是”,
“价值”:“296220096”
}
],
“任何”:[
{
“字段”:“current_tags”,
“运营商”:“包括”,
“价值”:“你好”
}
]
},
“id”:28,
“位置”:9,
“raw_title”:“{{dc.close_and_redirect}}”,
“标题”:“关闭并重定向到主题”
}
],
“数”:2,
“next_page”:零,
“previous_page”:零
}
显示自动化
GET / api / v2 /自动化/ {automation_id}
允许
- 代理
参数
名字 | 类型 | 在 | 要求 | 描述 |
---|---|---|---|---|
automation_id | 整数 | 路径 | 真正的 | 自动化的ID |
代码示例
旋度
旋度https://{子域名}.亚博zendesk.com/api/v2/automations/{automation_id}. json\
- v - u{电子邮件}:{密码}
去
进口(
“fmt”
“输入输出”
“net/http”
)
函数主要(){
url:=“https://example.亚博zendesk.com/api/v2/automations/25”
方法:=“获得”
要求的事情,犯错:=http.NewRequest(方法,url,零)
如果犯错! =零{
fmt.Println(犯错)
返回
}
要求的事情.头.添加(“内容类型”,“application / json”)
要求的事情.头.添加(“授权”,“基本< auth-value >”)// Base64编码的"username:password"
客户端:=&http.客户端{}
res,犯错:=客户端.做(要求的事情)
如果犯错! =零{
fmt.Println(犯错)
返回
}
推迟res.身体.关闭()
身体,犯错:=io.ReadAll(res.身体)
如果犯错! =零{
fmt.Println(犯错)
返回
}
fmt.Println(字符串(身体))
}
Java
进口com.squareup.okhttp.*;
OkHttpClient客户端=新OkHttpClient();
HttpUrl.构建器urlBuilder=HttpUrl.解析(“https://example.亚博zendesk.com/api/v2/automations/25”)
.newBuilder();
请求请求=新请求.构建器()
.url(urlBuilder.构建())
.方法(“获得”,零)
.addHeader(“内容类型”,“application / json”)
.addHeader(“授权”,凭证.基本(“电子邮件”,“你的密码”))
.构建();
响应响应=客户端.newCall(请求).执行();
Nodejs
varaxios=需要(“axios”);
var配置={
方法:“得到”,
url:“https://example.亚博zendesk.com/api/v2/automations/25”,
头:{
“内容类型”:“application / json”,
“授权”:的基本< auth-value >”,// Base64编码的"username:password"
},
};
axios(配置)
.然后(函数(响应){
控制台.日志(JSON.stringify(响应.数据));
})
.抓(函数(错误){
控制台.日志(错误);
});
Python
进口请求
url=“https://example.亚博zendesk.com/api/v2/automations/25”
头={
“内容类型”:“application / json”,
}
响应=请求.请求(
“获得”,
url,
身份验证=(“<用户名>”,' <密码> '),
头=头
)
打印(响应.文本)
鲁比(人名)
需要“net/http”
uri=URI(“https://example.亚博zendesk.com/api/v2/automations/25”)
请求=网::HTTP::得到.新(uri,“内容类型”:“application / json”)
请求.basic_auth“用户名”,“密码”
响应=网::HTTP.开始uri.主机名,uri.港口,use_ssl:真正的做|http|
http.请求(请求)
结束
示例响应(年代)
200好了
//状态200 OK
{
“自动化”:{
“行动”:[
{
“字段”:“状态”,
“价值”:“开放”
},
{
“字段”:“assignee_id”,
“价值”:“296220096”
}
],
“活跃”:真正的,
“条件”:{
“所有”:[
{
“字段”:“状态”,
“运营商”:“less_than”,
“价值”:“解决”
},
{
“字段”:“assignee_id”,
“运营商”:“是”,
“价值”:“296220096”
}
],
“任何”:[
{
“字段”:“current_tags”,
“运营商”:“包括”,
“价值”:“你好”
}
]
},
“id”:25,
“位置”:8,
“raw_title”:“关闭并保存”,
“标题”:“关闭并保存”
}
}
创建自动化
POST / api / v2 /自动化
创建自动化。
新的自动化必须是唯一的,并且至少具有一个仅为真一次的条件,或者至少具有一个使其中一个条件无效的操作。主动自动化可以有重叠的条件,但不可能完全相同。
请求中必须包含以下条件所有
数组:
- 至少一个基于时间的条件
- 至少有一个条件检查以下字段之一:
状态
,类型
,group_id
,assignee_id
,或requester_id
.
允许
- 代理
代码示例
旋度
旋度- u{电子邮件}:{密码}https://{子域名}.亚博zendesk.com/api/v2/automations.json\
- h“application / json内容类型:-X POST -d\
”{“自动化”:{“标题”:“罗杰照办”,“所有”:[{“字段”:“状态”,“操作符”:“是”,“价值”:“开放”},{“字段”:“优先”,“操作符”:“less_than”,“价值”:“高”}],“行动”:[{“字段”:“优先”,“价值”:“高”}]}}”
去
进口(
“fmt”
“输入输出”
“net/http”
)
函数主要(){
url:=“https://example.亚博zendesk.com/api/v2/automations”
方法:=“职位”
要求的事情,犯错:=http.NewRequest(方法,url,零)
如果犯错! =零{
fmt.Println(犯错)
返回
}
要求的事情.头.添加(“内容类型”,“application / json”)
要求的事情.头.添加(“授权”,“基本< auth-value >”)// Base64编码的"username:password"
客户端:=&http.客户端{}
res,犯错:=客户端.做(要求的事情)
如果犯错! =零{
fmt.Println(犯错)
返回
}
推迟res.身体.关闭()
身体,犯错:=io.ReadAll(res.身体)
如果犯错! =零{
fmt.Println(犯错)
返回
}
fmt.Println(字符串(身体))
}
Java
进口com.squareup.okhttp.*;
OkHttpClient客户端=新OkHttpClient();
HttpUrl.构建器urlBuilder=HttpUrl.解析(“https://example.亚博zendesk.com/api/v2/automations”)
.newBuilder();
RequestBody身体=RequestBody.创建(MediaType.解析(“application / json”),
”“"
”“");
请求请求=新请求.构建器()
.url(urlBuilder.构建())
.方法(“职位”,身体)
.addHeader(“内容类型”,“application / json”)
.addHeader(“授权”,凭证.基本(“电子邮件”,“你的密码”))
.构建();
响应响应=客户端.newCall(请求).执行();
Nodejs
varaxios=需要(“axios”);
var配置={
方法:“职位”,
url:“https://example.亚博zendesk.com/api/v2/automations”,
头:{
“内容类型”:“application / json”,
“授权”:的基本< auth-value >”,// Base64编码的"username:password"
},
};
axios(配置)
.然后(函数(响应){
控制台.日志(JSON.stringify(响应.数据));
})
.抓(函数(错误){
控制台.日志(错误);
});
Python
进口请求
url=“https://example.亚博zendesk.com/api/v2/automations”
头={
“内容类型”:“application / json”,
}
响应=请求.请求(
“职位”,
url,
身份验证=(“<用户名>”,' <密码> '),
头=头
)
打印(响应.文本)
鲁比(人名)
需要“net/http”
uri=URI(“https://example.亚博zendesk.com/api/v2/automations”)
请求=网::HTTP::帖子.新(uri,“内容类型”:“application / json”)
请求.basic_auth“用户名”,“密码”
响应=网::HTTP.开始uri.主机名,uri.港口,use_ssl:真正的做|http|
http.请求(请求)
结束
示例响应(年代)
201年创建
//状态201创建
{
“自动化”:{
“行动”:[
{
“字段”:“优先”,
“价值”:“高”
}
],
“活跃”:真正的,
“条件”:{
“所有”:[
{
“字段”:“状态”,
“运营商”:“是”,
“价值”:“开放”
},
{
“字段”:“优先”,
“运营商”:“less_than”,
“价值”:“高”
}
],
“任何”:[]
},
“id”:9873843,
“位置”:8,
“raw_title”:“罗杰照办”,
“标题”:“罗杰照办”
}
}
更新自动化
把/ api / v2 /自动化/ {automation_id}
更新自动化。
更新的自动化必须是唯一的,并且至少有一个只为真一次的条件,或者至少有一个使其中一个条件无效的操作。主动自动化可以有重叠的条件,但不可能完全相同。
请求中必须包含以下条件所有
数组:
- 至少一个基于时间的条件
- 至少一个检查以下字段之一的条件:'status'、'type'、'group_id'、' assignnee_id '或'requester_id'
请注意:更新条件或操作会同时更新条件
和行动
数组,清除两个数组的所有现有值。在更新任何条件或操作时,包括所有条件和操作。请注意您可能被限制更新一些默认的自动化。
允许
- 代理
参数
名字 | 类型 | 在 | 要求 | 描述 |
---|---|---|---|---|
automation_id | 整数 | 路径 | 真正的 | 自动化的ID |
代码示例
旋度
旋度- v - u{电子邮件}:{密码}https://{子域名}.亚博zendesk.com/api/v2/automations/{automation_id}. json\
- h“application / json内容类型:-X PUT -d'{"automation": {"title": "Roger Wilco II"}}'
去
进口(
“fmt”
“输入输出”
“net/http”
)
函数主要(){
url:=“https://example.亚博zendesk.com/api/v2/automations/25”
方法:=“把”
要求的事情,犯错:=http.NewRequest(方法,url,零)
如果犯错! =零{
fmt.Println(犯错)
返回
}
要求的事情.头.添加(“内容类型”,“application / json”)
要求的事情.头.添加(“授权”,“基本< auth-value >”)// Base64编码的"username:password"
客户端:=&http.客户端{}
res,犯错:=客户端.做(要求的事情)
如果犯错! =零{
fmt.Println(犯错)
返回
}
推迟res.身体.关闭()
身体,犯错:=io.ReadAll(res.身体)
如果犯错! =零{
fmt.Println(犯错)
返回
}
fmt.Println(字符串(身体))
}
Java
进口com.squareup.okhttp.*;
OkHttpClient客户端=新OkHttpClient();
HttpUrl.构建器urlBuilder=HttpUrl.解析(“https://example.亚博zendesk.com/api/v2/automations/25”)
.newBuilder();
RequestBody身体=RequestBody.创建(MediaType.解析(“application / json”),
”“"
”“");
请求请求=新请求.构建器()
.url(urlBuilder.构建())
.方法(“把”,身体)
.addHeader(“内容类型”,“application / json”)
.addHeader(“授权”,凭证.基本(“电子邮件”,“你的密码”))
.构建();
响应响应=客户端.newCall(请求).执行();
Nodejs
varaxios=需要(“axios”);
var配置={
方法:“把”,
url:“https://example.亚博zendesk.com/api/v2/automations/25”,
头:{
“内容类型”:“application / json”,
“授权”:的基本< auth-value >”,// Base64编码的"username:password"
},
};
axios(配置)
.然后(函数(响应){
控制台.日志(JSON.stringify(响应.数据));
})
.抓(函数(错误){
控制台.日志(错误);
});
Python
进口请求
url=“https://example.亚博zendesk.com/api/v2/automations/25”
头={
“内容类型”:“application / json”,
}
响应=请求.请求(
“把”,
url,
身份验证=(“<用户名>”,' <密码> '),
头=头
)
打印(响应.文本)
鲁比(人名)
需要“net/http”
uri=URI(“https://example.亚博zendesk.com/api/v2/automations/25”)
请求=网::HTTP::把.新(uri,“内容类型”:“application / json”)
请求.basic_auth“用户名”,“密码”
响应=网::HTTP.开始uri.主机名,uri.港口,use_ssl:真正的做|http|
http.请求(请求)
结束
示例响应(年代)
200好了
//状态200 OK
{
“自动化”:{
“行动”:[
{
“字段”:“状态”,
“价值”:“开放”
},
{
“字段”:“assignee_id”,
“价值”:“296220096”
}
],
“活跃”:真正的,
“条件”:{
“所有”:[
{
“字段”:“状态”,
“运营商”:“less_than”,
“价值”:“解决”
},
{
“字段”:“assignee_id”,
“运营商”:“是”,
“价值”:“296220096”
}
],
“任何”:[
{
“字段”:“current_tags”,
“运营商”:“包括”,
“价值”:“你好”
}
]
},
“id”:25,
“位置”:8,
“raw_title”:“关闭并保存”,
“标题”:“关闭并保存”
}
}
更新许多自动化
把/ api / v2 /自动化/ update_many
请注意您可能被限制更新一些默认的自动化。如果包含在批量更新中,则将更新不受限制的自动化。
允许
- 代理
请求参数
PUT请求需要一个自动化
对象,该对象列出要更新的自动化。
每个自动化可能具有以下属性:
名字 | 强制性的 | 描述 |
---|---|---|
id | 是的 | 要更新的自动化的ID |
位置 | 没有 | 自动化的新位置 |
活跃的 | 没有 | 自动化的活动状态(true或false) |
示例请求
{
“自动化”:[
{“id”:25,“位置”:3.},
{“id”:23,“位置”:5},
{“id”:27,“位置”:9},
{“id”:22,“位置”:7}
]
}
代码示例
旋度
旋度- v - u{电子邮件}:{密码}https://{子域名}.亚博zendesk.com/api/v2/automations/update_many.json\
- h“application / json内容类型:-X PUT -d{“自动化”:[{" id ": 26日,“位置”:8},{" id ": 25岁的“位置”:15}]}”
去
进口(
“fmt”
“输入输出”
“net/http”
)
函数主要(){
url:=“https://example.亚博zendesk.com/api/v2/automations/update_many”
方法:=“把”
要求的事情,犯错:=http.NewRequest(方法,url,零)
如果犯错! =零{
fmt.Println(犯错)
返回
}
要求的事情.头.添加(“内容类型”,“application / json”)
要求的事情.头.添加(“授权”,“基本< auth-value >”)// Base64编码的"username:password"
客户端:=&http.客户端{}
res,犯错:=客户端.做(要求的事情)
如果犯错! =零{
fmt.Println(犯错)
返回
}
推迟res.身体.关闭()
身体,犯错:=io.ReadAll(res.身体)
如果犯错! =零{
fmt.Println(犯错)
返回
}
fmt.Println(字符串(身体))
}
Java
进口com.squareup.okhttp.*;
OkHttpClient客户端=新OkHttpClient();
HttpUrl.构建器urlBuilder=HttpUrl.解析(“https://example.亚博zendesk.com/api/v2/automations/update_many”)
.newBuilder();
RequestBody身体=RequestBody.创建(MediaType.解析(“application / json”),
”“"
”“");
请求请求=新请求.构建器()
.url(urlBuilder.构建())
.方法(“把”,身体)
.addHeader(“内容类型”,“application / json”)
.addHeader(“授权”,凭证.基本(“电子邮件”,“你的密码”))
.构建();
响应响应=客户端.newCall(请求).执行();
Nodejs
varaxios=需要(“axios”);
var配置={
方法:“把”,
url:“https://example.亚博zendesk.com/api/v2/automations/update_many”,
头:{
“内容类型”:“application / json”,
“授权”:的基本< auth-value >”,// Base64编码的"username:password"
},
};
axios(配置)
.然后(函数(响应){
控制台.日志(JSON.stringify(响应.数据));
})
.抓(函数(错误){
控制台.日志(错误);
});
Python
进口请求
url=“https://example.亚博zendesk.com/api/v2/automations/update_many”
头={
“内容类型”:“application / json”,
}
响应=请求.请求(
“把”,
url,
身份验证=(“<用户名>”,' <密码> '),
头=头
)
打印(响应.文本)
鲁比(人名)
需要“net/http”
uri=URI(“https://example.亚博zendesk.com/api/v2/automations/update_many”)
请求=网::HTTP::把.新(uri,“内容类型”:“application / json”)
请求.basic_auth“用户名”,“密码”
响应=网::HTTP.开始uri.主机名,uri.港口,use_ssl:真正的做|http|
http.请求(请求)
结束
示例响应(年代)
200好了
//状态200 OK
{
“自动化”:[
{
“行动”:[
{
“字段”:“状态”,
“价值”:“开放”
},
{
“字段”:“assignee_id”,
“价值”:“296220096”
}
],
“活跃”:真正的,
“条件”:{
“所有”:[
{
“字段”:“状态”,
“运营商”:“less_than”,
“价值”:“解决”
},
{
“字段”:“assignee_id”,
“运营商”:“是”,
“价值”:“296220096”
}
],
“任何”:[
{
“字段”:“current_tags”,
“运营商”:“包括”,
“价值”:“你好”
}
]
},
“id”:25,
“位置”:15,
“raw_title”:“关闭并保存”,
“标题”:“关闭并保存”
},
{
“行动”:[
{
“字段”:“状态”,
“价值”:“开放”
},
{
“字段”:“assignee_id”,
“价值”:“296220096”
}
],
“活跃”:假,
“条件”:{
“所有”:[
{
“字段”:“状态”,
“运营商”:“less_than”,
“价值”:“解决”
},
{
“字段”:“assignee_id”,
“运营商”:“是”,
“价值”:“296220096”
}
],
“任何”:[
{
“字段”:“current_tags”,
“运营商”:“包括”,
“价值”:“你好”
}
]
},
“id”:26,
“位置”:8,
“raw_title”:“{{dc.assign_priority_tag}}”,
“标题”:“分配优先级标签”
}
],
“数”:2,
“next_page”:零,
“previous_page”:零
}
删除自动化
删除/ api / v2 /自动化/ {automation_id}
请注意:您可能被限制删除一些默认的自动设置。
允许
- 代理
参数
名字 | 类型 | 在 | 要求 | 描述 |
---|---|---|---|---|
automation_id | 整数 | 路径 | 真正的 | 自动化的ID |
代码示例
旋度
旋度- v - u{电子邮件}:{密码}https://{子域名}.亚博zendesk.com/api/v2/automations/{automation_id}. json\
- h“application / json内容类型:- x删除
去
进口(
“fmt”
“输入输出”
“net/http”
)
函数主要(){
url:=“https://example.亚博zendesk.com/api/v2/automations/25”
方法:=“删除”
要求的事情,犯错:=http.NewRequest(方法,url,零)
如果犯错! =零{
fmt.Println(犯错)
返回
}
要求的事情.头.添加(“内容类型”,“application / json”)
要求的事情.头.添加(“授权”,“基本< auth-value >”)// Base64编码的"username:password"
客户端:=&http.客户端{}
res,犯错:=客户端.做(要求的事情)
如果犯错! =零{
fmt.Println(犯错)
返回
}
推迟res.身体.关闭()
身体,犯错:=io.ReadAll(res.身体)
如果犯错! =零{
fmt.Println(犯错)
返回
}
fmt.Println(字符串(身体))
}
Java
进口com.squareup.okhttp.*;
OkHttpClient客户端=新OkHttpClient();
HttpUrl.构建器urlBuilder=HttpUrl.解析(“https://example.亚博zendesk.com/api/v2/automations/25”)
.newBuilder();
请求请求=新请求.构建器()
.url(urlBuilder.构建())
.方法(“删除”,零)
.addHeader(“内容类型”,“application / json”)
.addHeader(“授权”,凭证.基本(“电子邮件”,“你的密码”))
.构建();
响应响应=客户端.newCall(请求).执行();
Nodejs
varaxios=需要(“axios”);
var配置={
方法:“删除”,
url:“https://example.亚博zendesk.com/api/v2/automations/25”,
头:{
“内容类型”:“application / json”,
“授权”:的基本< auth-value >”,// Base64编码的"username:password"
},
};
axios(配置)
.然后(函数(响应){
控制台.日志(JSON.stringify(响应.数据));
})
.抓(函数(错误){
控制台.日志(错误);
});
Python
进口请求
url=“https://example.亚博zendesk.com/api/v2/automations/25”
头={
“内容类型”:“application / json”,
}
响应=请求.请求(
“删除”,
url,
身份验证=(“<用户名>”,' <密码> '),
头=头
)
打印(响应.文本)
鲁比(人名)
需要“net/http”
uri=URI(“https://example.亚博zendesk.com/api/v2/automations/25”)
请求=网::HTTP::删除.新(uri,“内容类型”:“application / json”)
请求.basic_auth“用户名”,“密码”
响应=网::HTTP.开始uri.主机名,uri.港口,use_ssl:真正的做|http|
http.请求(请求)
结束
示例响应(年代)
204无内容
//状态204无内容
零
批量删除自动化
删除/ api / v2 /自动化/ destroy_many
删除与所提供的以逗号分隔的id列表对应的自动化操作。
请注意:您可能被限制删除一些默认的自动设置。如果包含在批量删除中,则将删除不受限制的自动化。
允许
- 代理
请求参数
DELETE请求接受一个参数,即id
对象,该对象列出要删除的自动化。
名字 | 描述 |
---|---|
id | 需要删除的自动化的id |
示例请求
{
“id”:”27日,25日23日22
}
参数
名字 | 类型 | 在 | 要求 | 描述 |
---|---|---|---|---|
id | 数组 | 查询 | 假 | 需要删除的自动化的id |
代码示例
旋度
旋度https://{子域名}i亚博ds .zendesk.com/api/v2/automations/destroy_many.json吗?=1、2,3\
- v - u{电子邮件}:{密码}- x删除
去
进口(
“fmt”
“输入输出”
“net/http”
)
函数主要(){
url:=“https://example.亚博zendesk.com/api/v2/automations/destroy_many?ids=”
方法:=“删除”
要求的事情,犯错:=http.NewRequest(方法,url,零)
如果犯错! =零{
fmt.Println(犯错)
返回
}
要求的事情.头.添加(“内容类型”,“application / json”)
要求的事情.头.添加(“授权”,“基本< auth-value >”)// Base64编码的"username:password"
客户端:=&http.客户端{}
res,犯错:=客户端.做(要求的事情)
如果犯错! =零{
fmt.Println(犯错)
返回
}
推迟res.身体.关闭()
身体,犯错:=io.ReadAll(res.身体)
如果犯错! =零{
fmt.Println(犯错)
返回
}
fmt.Println(字符串(身体))
}
Java
进口com.squareup.okhttp.*;
OkHttpClient客户端=新OkHttpClient();
HttpUrl.构建器urlBuilder=HttpUrl.解析(“https://example.亚博zendesk.com/api/v2/automations/destroy_many”)
.newBuilder()
.addQueryParameter(“id”,”“);
请求请求=新请求.构建器()
.url(urlBuilder.构建())
.方法(“删除”,零)
.addHeader(“内容类型”,“application / json”)
.addHeader(“授权”,凭证.基本(“电子邮件”,“你的密码”))
.构建();
响应响应=客户端.newCall(请求).执行();
Nodejs
varaxios=需要(“axios”);
var配置={
方法:“删除”,
url:“https://example.亚博zendesk.com/api/v2/automations/destroy_many”,
头:{
“内容类型”:“application / json”,
“授权”:的基本< auth-value >”,// Base64编码的"username:password"
},
参数个数:{
“id”:'',
},
};
axios(配置)
.然后(函数(响应){
控制台.日志(JSON.stringify(响应.数据));
})
.抓(函数(错误){
控制台.日志(错误);
});
Python
进口请求
url=“https://example.亚博zendesk.com/api/v2/automations/destroy_many?ids=”
头={
“内容类型”:“application / json”,
}
响应=请求.请求(
“删除”,
url,
身份验证=(“<用户名>”,' <密码> '),
头=头
)
打印(响应.文本)
鲁比(人名)
需要“net/http”
uri=URI(“https://example.亚博zendesk.com/api/v2/automations/destroy_many”)
uri.查询=URI.encode_www_form(“id”:”“)
请求=网::HTTP::删除.新(uri,“内容类型”:“application / json”)
请求.basic_auth“用户名”,“密码”
响应=网::HTTP.开始uri.主机名,uri.港口,use_ssl:真正的做|http|
http.请求(请求)
结束
示例响应(年代)
204无内容
//状态204无内容
零