工单系统旧版
查询工单满意度评价结果
按 ticketId 查询满意度评价结果,并按企业多语言设置替换评价提示文案。没有评价记录时 data.evaluation 为空对象,且不返回 isResolved;存在评价记录时返回 isResolved 和评价详情。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳(秒) | |
| checksum | string | 是 | 请求签名校验和 | |
| checksumAlgorithm | int32 | 否 | 签名算法:0 - 默认(SHA1),1 - SHA256 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ticketId | int64 | 是 | 工单 ID | 123456 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 状态码,200 表示成功 | 200 |
| data | object | 评价结果数据 | {"isResolved":1,"evaluation":{"evaluationModel":5,"evaluationValue":100}} |
| └isResolved | int32 | 是否解决:0-未填写,1-解决,2-未解决;仅存在评价记录时返回 | 1 |
| └evaluation | object | 工单评价详情 | {"evaluationModel":5,"evaluationValue":100,"evaluationStatus":1} |
| └evaluationModel | int32 | 评价模型 | 5 |
| └evaluationValue | int32 | 评价值 | 100 |
| └evaluationTags | string | 评价标签列表字符串 | [{"id":1,"name":"响应快"}] |
| └evaluationContent | string | 评价内容 | 处理及时,问题已解决 |
| └evaluationStatus | int32 | 评价状态;默认未定义,存在评价且需要评价时使用评价记录状态 | 1 |
| └needEvaluation | boolean | 是否需要评价 | true |
| └evaluationTxt | string | 评价提示文案,会按企业多语言配置替换 | 已评价 |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 不存在 |
| 14002 | checksum 校验失败 |
| 14003 | time 缺失,或请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求体不是合法 JSON |
| 14106 | ticketId 缺失或为 0;企业管理员不存在;工单已删除;或当前企业下工单不存在 |
| 14500 | 服务内部异常;请求字段类型不符合要求或服务处理失败 |
postEndpoint
/openapi/worksheet/satisfaction/getEvaluationWithRulecurl -X POST "https://qiyukf.com/openapi/worksheet/satisfaction/getEvaluationWithRule?appKey=9f1d7c2b8a6e4d3c&time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef&checksumAlgorithm=0" \ -H "Content-Type: application/json" \ -d '{ "ticketId": 123456 }'{
"code": 200,
"data": {
"isResolved": 1,
"evaluation": {
"evaluationModel": 5,
"evaluationValue": 100
}
}
}{
"code": 14001,
"message": "AppKey 不存在"
}{
"code": 14002,
"message": "checksum 校验失败"
}{
"code": 14003,
"message": "time 缺失,或请求时间戳与服务器时间误差超过 10 分钟"
}{
"code": 14004,
"message": "请求体不是合法 JSON"
}{
"code": 14106,
"message": "ticketId 缺失或为 0;企业管理员不存在;工单已删除;或当前企业下工单不存在"
}{
"code": 14500,
"message": "服务内部异常;请求字段类型不符合要求或服务处理失败"
}这篇文档有帮助吗?