搜索工单

接口参数说明如下：

其中自定义字段如果是级联类型的，其fieldValue格式如：

{
  "path": "1级/1.1级",  // 每一级的完整名称
  "idpath": [1555974, 1555977], // 每一级对应的ID
  "id": 1555977 //级联自定义字段ID
}

ticketId和mobile二选一，时间跨度不得超过90天。

curl --location --request POST 'https://qiyukf.com/openapi/v2/ticket/search?appKey=&time=&checksum=' \ --header 'Content-Type: application/json' \ --data-raw '{ "ticketId":123, "mobile":"18668686868", "limit":50, "offset": 0, "sortBy":"ct", "order":"asc", "start":1498736257082, "end":1498736257082, "opStart":1498736257082, "opEnd":1498736257082, "withCustomField":false, "uid":"abc175" }'

{ "code": 200, "message": { "total": 100, "tickets": [ { "id": 123, "staffId": 123456, "templateId": 12345, "userName": "大门", "userEmail": "a@b.c", "userMobile": "18668686868", "typeId": 11, "priority": 1, "groupId": 12345, "title": "退货", "content": "太好了", "status": 5, "properties": "{}", "createTime": 1498736257082, "custom": [ { "id": 111, "name": "abc", "value": "def" } ] } ] } }

请求参数

Query 参数

appKey

string

必需

企业的appKey，1064deea1c3624c9ee26d1de5ce8481f

默认值:

time

string

必需

当前 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数,1463217187

默认值:

checksum

string

必需

SHA1(appSecret + md5 + time), 三个参数拼接的字符串，进行SHA1哈希计算，转化成16进制字符(String，小写).示例2f13932c4b7c6888b12360a85261a11b8b543f64

默认值:

Body 参数application/json

ticketId

integer

工单ID

可选

mobile

string

用户手机号

可选

limit

integer

可选

一次请求获取的工单数上限，最大为50

offset

integer

偏移量

可选

sortBy

string

可选

排序方式，默认为"ct"创建时间

order

string

可选

升降序，默认desc，降序

start

integer

可选

起始毫秒时间戳（若不传该参数，则默认支持时间跨度为30天）

end

integer

截止毫秒时间戳

可选

opStart

integer

可选

操作时间起始毫秒时间戳

opEnd

integer

可选

操作时间截止毫秒时间戳（不超过90天）

withCustomField

boolean

可选

是否包含自定义字段信息

uid

string

可选

访客的foreignid

示例

application/json

Body

code

integer

必需

message

object

必需

message包含指定用户当前过滤器下的工单数量以及工单列表

total

integer

必需

tickets

array [object {15}]

必需

请求参数

返回响应