七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
工单系统

更新工单关注人

添加或移除工单的关注人,关注人坐席必须具有工单权限。任一关注人无工单权限时,整个请求失败(非部分成功)。

请求参数

名称类型必填描述示例值
appKeystring是应用 AppKey
timeint64是请求时间戳(秒)
checksumstring是请求签名校验和
checksumAlgorithmint32否签名算法:0 - 默认(SHA1),1 - SHA256

请求体

名称类型必填描述示例值
ticketIdint64是工单 ID123456
staffIdint64是操作坐席 ID10001
optypeint32是操作类型:0-添加,1-移除0
followersstring是坐席 ID 列表,JSON 数组字符串,如 "[1001,1002]"[10003,10004]

返回参数

名称类型描述示例值
codeint32状态码,200 表示成功200
messagestring提示信息:成功时为业务数据,失败时为错误描述true

错误码

状态码描述
8802followers 中某坐席无工单权限
8814工单不存在
14004ticketId/staffId/optype/followers 为空;JSON 格式错误
14100staffId 不存在或已停用
14500服务内部异常
postEndpoint
/openapi/v2/ticket/followers/update
POST
/openapi/v2/ticket/followers/update
curl -X POST "https://qiyukf.com/openapi/v2/ticket/followers/update?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "ticketId": 123456,    "staffId": 10001,    "optype": 0,    "followers": "[10003,10004]"  }'
{
  "code": 200,
  "message": "true"
}
{
  "code": 8802,
  "message": "followers 中某坐席无工单权限"
}
{
  "code": 8814,
  "message": "工单不存在"
}
{
  "code": 14004,
  "message": "ticketId/staffId/optype/followers 为空;JSON 格式错误"
}
{
  "code": 14100,
  "message": "staffId 不存在或已停用"
}
{
  "code": 14500,
  "message": "服务内部异常"
}

这篇文档有帮助吗?