工单系统
查询工单过滤器列表
返回指定企业的工单过滤器。指定 staffId 时只返回该坐席的过滤器;不指定时返回企业全量过滤器。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳(秒) | |
| checksum | string | 是 | 请求签名校验和 | |
| checksumAlgorithm | int32 | 否 | 签名算法:0 - 默认(SHA1),1 - SHA256 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| status | int32 | 否 | 过滤状态:0-全量(默认),1-启用,2-停用;其他值返回空列表 | 0 |
| staffId | int64 | 否 | 坐席 ID;指定时只返回该坐席的过滤器,不指定时返回企业全量过滤器 | 10001 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 状态码,200 表示成功 | 200 |
| message | object[] | 过滤器列表 | [{"id":70001,"name":"我的工单","status":1,"crossType":0}] |
| └id | int64 | 过滤器 ID | 70001 |
| └name | string | 过滤器名称 | 我的工单 |
| └status | int32 | 过滤器状态:1-启用,2-停用,3-已删除 | 1 |
| └crossType | int32 | 跨组类型:0-非跨组,1-跨组 | 0 |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 不存在 |
| 14002 | checksum 校验失败 |
| 14003 | 请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求体不是合法 JSON |
| 14500 | 服务内部异常 |
postEndpoint
/openapi/v2/ticket/filter/listcurl -X POST "https://qiyukf.com/openapi/v2/ticket/filter/list?appKey=string&time=0&checksum=string" \ -H "Content-Type: application/json" \ -d '{}'{
"code": 200,
"message": [
{
"id": 70001,
"name": "我的工单",
"status": 1,
"crossType": 0
}
]
}{
"code": 14001,
"message": "AppKey 不存在"
}{
"code": 14002,
"message": "checksum 校验失败"
}{
"code": 14003,
"message": "请求时间戳与服务器时间误差超过 10 分钟"
}{
"code": 14004,
"message": "请求体不是合法 JSON"
}{
"code": 14500,
"message": "服务内部异常"
}这篇文档有帮助吗?