工单系统
查询工单模板列表
返回企业下启用和停用状态的工单模板(不含已删除)。status=-1 或不传时返回全量,其他整数值精确匹配模板 status 字段;已删除模板不在查询范围内。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳(秒) | |
| checksum | string | 是 | 请求签名校验和 | |
| checksumAlgorithm | int32 | 否 | 签名算法:0 - 默认(SHA1),1 - SHA256 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| status | int32 | 否 | 状态过滤:-1-全量(默认),0-停用,1-启用,2-已删除;其他值返回空列表 | -1 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 状态码,200 表示成功 | 200 |
| message | object[] | 模板列表 | [{"id":30001,"name":"售后投诉","status":1,"autoFlow":0,"createTime":1720085400000,"autoStatus":0,"autoGuide":"","fileStatus":1}] |
| └id | int64 | 模板 ID | 30001 |
| └name | string | 模板名称 | 售后投诉 |
| └status | int32 | 模板状态:0-停用,1-启用,2-已删除;当前列表不返回已删除模板 | 1 |
| └autoFlow | int32 | 自动流转设置:0-关闭,1-启用 | 0 |
| └createTime | int64 | 创建时间(毫秒时间戳) | 1720085400000 |
| └autoStatus | int32 | 自动提单状态:0-停用,1-启用 | 0 |
| └autoGuide | string | 自动提单引导语 | 请填写您遇到的问题 |
| └fileStatus | int32 | 文件上传开关:0-停用,1-启用 | 1 |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 不存在 |
| 14002 | checksum 校验失败 |
| 14003 | 请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求体不是合法 JSON |
| 14500 | 服务内部异常 |
postEndpoint
/openapi/v2/ticket/template/listcurl -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": "服务内部异常"
}这篇文档有帮助吗?