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

查询工单模板列表

返回企业下启用和停用状态的工单模板(不含已删除)。status=-1 或不传时返回全量,其他整数值精确匹配模板 status 字段;已删除模板不在查询范围内。

请求参数

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

请求体

名称类型必填描述示例值
statusint32否状态过滤:-1-全量(默认),0-停用,1-启用,2-已删除;其他值返回空列表-1

返回参数

名称类型描述示例值
codeint32状态码,200 表示成功200
messageobject[]模板列表[{"id":30001,"name":"售后投诉","status":1,"autoFlow":0,"createTime":1720085400000,"autoStatus":0,"autoGuide":"","fileStatus":1}]
└idint64模板 ID30001
└namestring模板名称售后投诉
└statusint32模板状态:0-停用,1-启用,2-已删除;当前列表不返回已删除模板1
└autoFlowint32自动流转设置:0-关闭,1-启用0
└createTimeint64创建时间(毫秒时间戳)1720085400000
└autoStatusint32自动提单状态:0-停用,1-启用0
└autoGuidestring自动提单引导语请填写您遇到的问题
└fileStatusint32文件上传开关:0-停用,1-启用1

错误码

状态码描述
14001AppKey 不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求体不是合法 JSON
14500服务内部异常
postEndpoint
/openapi/v2/ticket/template/list
POST
/openapi/v2/ticket/template/list
curl -X POST "https://qiyukf.com/openapi/v2/ticket/template/list?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "code": 200,
  "message": [
    {
      "id": 30001,
      "name": "售后投诉",
      "status": 1,
      "autoFlow": 0,
      "createTime": 1720085400000,
      "autoStatus": 0,
      "autoGuide": "",
      "fileStatus": 1
    }
  ]
}
{
  "code": 14001,
  "message": "AppKey 不存在"
}
{
  "code": 14002,
  "message": "checksum 校验失败"
}
{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}
{
  "code": 14004,
  "message": "请求体不是合法 JSON"
}
{
  "code": 14500,
  "message": "服务内部异常"
}

这篇文档有帮助吗?