修改工单单个字段

修改工单的单个字段值，每次只能修改一个字段（type 参数决定字段类型）。type=0（自定义字段）：customId 与 fieldId 二选一定位记录；必填项 value 不能为空；附件类型字段需通过 getFieldValue 转换。type=2（优先级）：value 必须为 2（低）、5（一般）、8（紧急）、10（非常紧急）之一；type=3（分类）：传空或 0 代表未分类，否则需校验分类存在且未删除。修改前会校验工单是否已被删除。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和
checksumAlgorithm	int32	否	签名算法：0 - 默认(SHA1)，1 - SHA256

请求体

名称	类型	必填	描述	示例值
ticketId	int64	是	工单 ID	123456
staffId	int64	是	操作坐席 ID	10001
type	int32	是	字段类型：0-自定义字段，1-标题，2-优先级，3-分类，4-用户姓名，5-用户手机，6-用户邮箱	0
value	string	是	新值；type=2（优先级）时仅支持 2-低、5-一般、8-紧急、10-非常紧急	SO202407010001
customId	int64	否	自定义字段记录 ID（type=0 时，与 fieldId 二选一）	91001
fieldId	int64	否	自定义字段定义 ID（type=0 时，与 customId 二选一）	81001
tricky	boolean	否	是否静默修改（不触发通知），默认 false	false

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
message	string	提示信息：成功时为业务数据，失败时为错误描述	true

错误码

状态码	描述
14004	必填字段为空；优先级值非法；分类不存在；customId/fieldId 定位失败；type 非法；JSON 格式错误
14100	staffId 不存在或已停用
14106	工单已被删除
14500	服务内部异常

postEndpoint

/openapi/v2/ticket/modify

curl -X POST "https://qiyukf.com/openapi/v2/ticket/modify?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "ticketId": 123456,    "staffId": 10001,    "type": 0,    "value": "SO202407010001"  }'

{
  "code": 200,
  "message": "true"
}

{
  "code": 14004,
  "message": "必填字段为空；优先级值非法；分类不存在；customId/fieldId 定位失败；type 非法；JSON 格式错误"
}

{
  "code": 14100,
  "message": "staffId 不存在或已停用"
}

{
  "code": 14106,
  "message": "工单已被删除"
}

{
  "code": 14500,
  "message": "服务内部异常"
}