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

查询工单满意度评价规则

按 ticketId 查询工单满意度评价规则。ticketId 缺失、为 0、企业管理员不存在、工单已删除或工单不存在时返回工单不存在错误;成功时 data 为评价规则对象。

请求参数

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

请求体

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

返回参数

名称类型描述示例值
codeint32状态码,200 表示成功200
dataobject工单满意度评价规则{"model":5,"resolvedEnabled":1,"messageInvite":"请对本次服务进行评价"}
└listobject[]满意度模型设置列表[{"model":5,"title":"请对本次服务进行评价"}]
└modelint32满意度模型档位数5
└titlestring满意度模型标题请对本次服务进行评价
└notestring满意度模型说明您的评价将帮助我们持续改进服务
└resolvedEnabledint32是否启用问题是否解决评价1
└resolvedRequiredint32问题是否解决评价是否必填0
└settingsobject[]满意度评价项列表[{"name":"非常满意","value":100,"tagList":["响应快"]}]
└namestring评价项名称非常满意
└valueint32评价值100
└tagListstring[]可选评价标签列表["响应快","态度好"]
└tagRequiredboolean评价标签是否必填false
└commentRequiredboolean评价内容是否必填false
└resolvedEnabledint32是否启用问题是否解决评价1
└resolvedRequiredint32问题是否解决评价是否必填0
└messageInvitestring邀评提示文案请对本次服务进行评价
└messageThanksstring评价完成感谢文案感谢您的评价
└messageExpiredstring评价已过期提示文案本次评价已过期
└messageDuplicatestring重复评价提示文案您已经提交过评价
└messageReopenstring重新打开评价提示文案请重新评价本次服务
└modelint32满意度模型档位数5
└evaluationWayint32评价方式1

错误码

状态码描述
14001AppKey 不存在
14002checksum 校验失败
14003time 缺失,或请求时间戳与服务器时间误差超过 10 分钟
14004请求体不是合法 JSON
14106ticketId 缺失或为 0;企业管理员不存在;工单已删除;或当前企业下工单不存在
14500服务内部异常;请求字段类型不符合要求或服务处理失败
postEndpoint
/openapi/worksheet/satisfaction/getRule
POST
/openapi/worksheet/satisfaction/getRule
curl -X POST "https://qiyukf.com/openapi/worksheet/satisfaction/getRule?appKey=9f1d7c2b8a6e4d3c&time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef&checksumAlgorithm=0" \  -H "Content-Type: application/json" \  -d '{    "ticketId": 123456  }'
{
  "code": 200,
  "data": {
    "model": 5,
    "resolvedEnabled": 1,
    "messageInvite": "请对本次服务进行评价"
  }
}
{
  "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": "服务内部异常;请求字段类型不符合要求或服务处理失败"
}

这篇文档有帮助吗?