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

流程节点条件回调

第三方接口回调流程节点条件判断结果。ticketId、nodeExecRecordId、conditionLineId、result 均必须存在且能按对应类型解析;工单不存在时返回工单不存在错误;流程回调失败时返回参数错误并在 message 中说明原因。

请求参数

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

请求体

名称类型必填描述示例值
ticketIdint64是工单 ID123456
nodeExecRecordIdint64是节点执行记录 ID(JSON 字段名 nodeExecRecordId)567890
conditionLineIdint64是条件线 ID(JSON 字段名 conditionLineId)30001
resultboolean是第三方条件判断结果true

返回参数

名称类型描述示例值
codeint32状态码,200 表示成功200
messagestring成功消息或业务结果success

错误码

状态码描述
8002流程回调失败,message 为具体业务错误信息
14001AppKey 不存在
14002checksum 校验失败
14003time 缺失,或请求时间戳与服务器时间误差超过 10 分钟
14004请求体不是合法 JSON;或 ticketId、nodeExecRecordId、conditionLineId、result 缺失/类型不合法
14106当前企业下 ticketId 对应工单不存在
14500服务内部异常;流程条件处理失败
postEndpoint
/openapi/worksheet/process/node/condition/callback
POST
/openapi/worksheet/process/node/condition/callback
curl -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": "服务内部异常;流程条件处理失败"
}

这篇文档有帮助吗?