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

查询工单分类列表

返回企业下启用状态的工单分类列表。请求体 type 必填,目前仅支持 type=2(工单分类);其他类型返回 14200。

请求参数

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

请求体

名称类型必填描述示例值
typeint32是分类类型:2-工单分类,目前仅支持 22

返回参数

名称类型描述示例值
codeint32状态码,200 表示成功200
messageobject[]工单分类列表[{"id":40001,"parentId":0,"name":"售后服务","rank":1},{"id":40002,"parentId":40001,"name":"退款问题","rank":2}]
└idint64分类 ID40001
└parentIdint64父级分类 ID,顶级分类为 00
└namestring分类名称售后服务
└rankint32分类排序值1

错误码

状态码描述
14001AppKey 不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004type 缺失;请求体 JSON 格式错误
14200不支持的分类类型
14500服务内部异常
postEndpoint
/openapi/category/list
POST
/openapi/category/list
curl -X POST "https://qiyukf.com/openapi/category/list?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "type": 2  }'
{
  "code": 200,
  "message": [
    {
      "id": 40001,
      "parentId": 0,
      "name": "售后服务",
      "rank": 1
    },
    {
      "id": 40002,
      "parentId": 40001,
      "name": "退款问题",
      "rank": 2
    }
  ]
}
{
  "code": 14001,
  "message": "AppKey 不存在"
}
{
  "code": 14002,
  "message": "checksum 校验失败"
}
{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}
{
  "code": 14004,
  "message": "type 缺失;请求体 JSON 格式错误"
}
{
  "code": 14200,
  "message": "不支持的分类类型"
}
{
  "code": 14500,
  "message": "服务内部异常"
}

这篇文档有帮助吗?