工单系统
更新工单关注人
添加或移除工单的关注人,关注人坐席必须具有工单权限。任一关注人无工单权限时,整个请求失败(非部分成功)。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳(秒) | |
| checksum | string | 是 | 请求签名校验和 | |
| checksumAlgorithm | int32 | 否 | 签名算法:0 - 默认(SHA1),1 - SHA256 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ticketId | int64 | 是 | 工单 ID | 123456 |
| staffId | int64 | 是 | 操作坐席 ID | 10001 |
| optype | int32 | 是 | 操作类型:0-添加,1-移除 | 0 |
| followers | string | 是 | 坐席 ID 列表,JSON 数组字符串,如 "[1001,1002]" | [10003,10004] |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 状态码,200 表示成功 | 200 |
| message | string | 提示信息:成功时为业务数据,失败时为错误描述 | true |
错误码
| 状态码 | 描述 |
|---|---|
| 8802 | followers 中某坐席无工单权限 |
| 8814 | 工单不存在 |
| 14004 | ticketId/staffId/optype/followers 为空;JSON 格式错误 |
| 14100 | staffId 不存在或已停用 |
| 14500 | 服务内部异常 |
postEndpoint
/openapi/v2/ticket/followers/updatecurl -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": "服务内部异常"
}这篇文档有帮助吗?