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

查询工单满意度评价结果

按 ticketId 查询满意度评价结果,并按企业多语言设置替换评价提示文案。没有评价记录时 data.evaluation 为空对象,且不返回 isResolved;存在评价记录时返回 isResolved 和评价详情。

请求参数

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

请求体

名称类型必填描述示例值
ticketIdint64是工单 ID123456

返回参数

名称类型描述示例值
codeint32状态码,200 表示成功200
dataobject评价结果数据{"isResolved":1,"evaluation":{"evaluationModel":5,"evaluationValue":100}}
└isResolvedint32是否解决:0-未填写,1-解决,2-未解决;仅存在评价记录时返回1
└evaluationobject工单评价详情{"evaluationModel":5,"evaluationValue":100,"evaluationStatus":1}
└evaluationModelint32评价模型5
└evaluationValueint32评价值100
└evaluationTagsstring评价标签列表字符串[{"id":1,"name":"响应快"}]
└evaluationContentstring评价内容处理及时,问题已解决
└evaluationStatusint32评价状态;默认未定义,存在评价且需要评价时使用评价记录状态1
└needEvaluationboolean是否需要评价true
└evaluationTxtstring评价提示文案,会按企业多语言配置替换已评价

错误码

状态码描述
14001AppKey 不存在
14002checksum 校验失败
14003time 缺失,或请求时间戳与服务器时间误差超过 10 分钟
14004请求体不是合法 JSON
14106ticketId 缺失或为 0;企业管理员不存在;工单已删除;或当前企业下工单不存在
14500服务内部异常;请求字段类型不符合要求或服务处理失败
postEndpoint
/openapi/worksheet/satisfaction/getEvaluationWithRule
POST
/openapi/worksheet/satisfaction/getEvaluationWithRule
curl -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": "服务内部异常;请求字段类型不符合要求或服务处理失败"
}

这篇文档有帮助吗?