工单系统旧版
流程节点条件回调
第三方接口回调流程节点条件判断结果。ticketId、nodeExecRecordId、conditionLineId、result 均必须存在且能按对应类型解析;工单不存在时返回工单不存在错误;流程回调失败时返回参数错误并在 message 中说明原因。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳(秒) | |
| checksum | string | 是 | 请求签名校验和 | |
| checksumAlgorithm | int32 | 否 | 签名算法:0 - 默认(SHA1),1 - SHA256 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ticketId | int64 | 是 | 工单 ID | 123456 |
| nodeExecRecordId | int64 | 是 | 节点执行记录 ID(JSON 字段名 nodeExecRecordId) | 567890 |
| conditionLineId | int64 | 是 | 条件线 ID(JSON 字段名 conditionLineId) | 30001 |
| result | boolean | 是 | 第三方条件判断结果 | true |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 状态码,200 表示成功 | 200 |
| message | string | 成功消息或业务结果 | success |
错误码
| 状态码 | 描述 |
|---|---|
| 8002 | 流程回调失败,message 为具体业务错误信息 |
| 14001 | AppKey 不存在 |
| 14002 | checksum 校验失败 |
| 14003 | time 缺失,或请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求体不是合法 JSON;或 ticketId、nodeExecRecordId、conditionLineId、result 缺失/类型不合法 |
| 14106 | 当前企业下 ticketId 对应工单不存在 |
| 14500 | 服务内部异常;流程条件处理失败 |
postEndpoint
/openapi/worksheet/process/node/condition/callbackcurl -X POST "https://qiyukf.com/openapi/worksheet/process/node/condition/callback?appKey=9f1d7c2b8a6e4d3c&time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef&checksumAlgorithm=0" \ -H "Content-Type: application/json" \ -d '{ "ticketId": 123456, "nodeExecRecordId": 567890, "conditionLineId": 30001, "result": true }'{
"code": 200,
"message": "success"
}{
"code": 8002,
"message": "流程回调失败,message 为具体业务错误信息"
}{
"code": 14001,
"message": "AppKey 不存在"
}{
"code": 14002,
"message": "checksum 校验失败"
}{
"code": 14003,
"message": "time 缺失,或请求时间戳与服务器时间误差超过 10 分钟"
}{
"code": 14004,
"message": "请求体不是合法 JSON;或 ticketId、nodeExecRecordId、conditionLineId、result 缺失/类型不合法"
}{
"code": 14106,
"message": "当前企业下 ticketId 对应工单不存在"
}{
"code": 14500,
"message": "服务内部异常;流程条件处理失败"
}这篇文档有帮助吗?