推
如果拉Zendesk support提供的支亚博持对你的用例来说不够及时,你也可以编写代码,直接调用Zendesk API来将内容推送给Zendesk support。支持推比支持拉要费力得多,所以只有在确定需要时才应该尝试。
推的元素
通过向Zendesk API推送端亚博点发出POST请求,可以将数据推送到Zendesk Support。POST请求必须通过Channel框架生成的OAuth令牌进行身份验证。在Channel框架为您生成令牌之前,您必须向Zendesk Supp亚博ort注册一个客户端ID。
使用push:
- 创建一个新的全局OAuth客户端如下面所述,或使用已存在的客户机。
- 设置
push_client_id
的价值清单将您的服务转换为全局客户机的唯一标识符。 - 当管理员使用您的UI创建一个新的集成帐户时,记录子域和访问令牌传递给你的服务.
- 方法调用子域和访问令牌推动端点是合适的。
创建全局OAuth客户端
- 在Zendesk Support中创建或获取OAuth客户端,如亚博对应用程序使用OAuth身份验证.
- 描述不能为空
- 记录唯一标识符和秘密
- 中所描述的完成请求表单,将OAuth客户端提升为“全局”客户端设置一个全局OAuth客户端.
获取访问令牌
当Zendes亚博k支持管理员设置或编辑集成帐户时,Zendesk支持将调用您的管理界面.如果你的清单包括一个push_client_id
入口,Zend亚博esk支持将生成一个访问令牌,并将其传递给您的接口。具体来说,以下数据将被post到您的服务:
Post字段名 | 类型 | 评论 |
---|---|---|
子域名 | 字符串 | Zendesk支持帐户的子域,该帐户正在使亚博用您的服务设置帐户 |
instance_push_id | 字符串 | 正在设置的帐户的ID。调用推动端点 |
亚博zendesk_access_token | 字符串 | 调用时使用的OAuth令牌推动端点.此令牌不能与其他端点一起使用,而其他令牌也不能用于访问推送端点 |
注意,此信息仅对您的管理界面可用。您应该以安全的方式记录此信息,以供后续使用。
调用push端点
获得子域、实例推送id和访问令牌之后,就可以调用推动端点同步推送集成内容到Zendesk支持。亚博
无效的请求
方法验证JSON通道框架模式.发送错误类型的JSON值将导致400个Bad Request响应。
POST / api / v2 / any_channel /推动。json HTTP /1.1
宿主:sample.亚博zendesk.com
内容类型:application / json
HTTP /1.1400坏的请求
{
“错误”:{
“消息”:[
//bundle/gems/any_channel_亚博电脑端json_schemas-0.4.0/json_schemas/external_resource.json#中'#/external_resources/0'属性不包含' external__id '的必需属性
]
}
}