文档 API参考

徽章的作业

分配徽章会增加一个徽章到帮助中心中特定用户的配置文件。

徽章可以在聚集专业计划中获得。

JSON格式

徽章分配是JSON对象，具有以下属性:

名字 类型 只读 强制性的 评论
id 字符串 是的 没有 在创建徽章分配时自动分配
badge_id 字符串 没有 是的 徽章的id
user_id 字符串 没有 是的 用户id
created_at 时间戳 是的 没有 创建徽章分配时

例子

             

              
{“id”：“01 e86xpxh5bk09krwtdvekvvy8”，“badge_id”：“01 e86xpprdcnhytsvwsrmd76r0”，“user_id”：“57919551”，“created_at”：“2020 - 05 - 13 - t11:46:26.000z”}

列出徽章分配

  • 得到/ api / v2 /收集/ badge_assignments

您可以使用以下查询参数的任意组合来过滤结果:

  • user_id
  • badge_id
  • badge_category_id
  • brand_id

例子:

  • GET / api / v2 /收集/ badge_assignments吗?user_id = {user_id}
  • GET / api / v2 /收集/ badge_assignments吗?user_id = {user_id} &brand_id = {brand_id}
  • GET / api / v2 /收集/ badge_assignments吗?badge_id = {badge_id}
  • GET / api / v2 /收集/ badge_assignments吗?badge_category_id = {badge_category_id}

允许

  • 帮助中心经理

参数

名字 类型 在 要求 描述
user_id 整数 查询 假 返回指定用户的赋值
badge_id 整数 查询 假 返回指定徽章的分配
badge_category_id 整数 查询 假 返回指定类别下徽章的作业
brand_id 整数 查询 假 返回指定品牌的分配

使用旋度

             

              
旋度“https://{子域名}.zendes亚博k.com/api/v2/gather/badge_assignments ? badge_id = 01 e89dz2na6zpmbmrpfrxc2bry '＼- v - u{email_address}：{密码}

示例响应

             

              
状态:200 OK{“badge_assignments”:({“id”:“01 e86xpxh5bk09krwtdvekvvy8”,“badge_id”:“01 e89dz2na6zpmbmrpfrxc2bry”,“user_id”:“57919551”,“created_at”:“2020 - 05 - 13 - t11:46:26.000z”}］}

创建徽章分配

  • POST / api / v2 /收集/ badge_assignments

允许

  • 帮助中心经理

使用旋度

             

              
旋度https://{子域名}.亚博zendesk.com/api/v2/gather/badges＼- v - u{email_address}：{密码}- d”{badge_assignment”:{“badge_id”:“{{badge_id}}”,“user_id”:“{{user_id}}}}”＼-x post -h“application / json内容类型:

删除徽章分配

  • 删除/ api / v2 /收集/ badge_assignments / {id}

允许

  • 帮助中心经理

使用旋度

             

              
旋度https://{子域名}.亚博zendesk.com/api/v2/gather/badge_assignments/{id}＼- v - u{email_address}：{密码}- x删除

示例响应

             

              
状态:204无内容