ezbuy.issue.search(获取工单列表)
GET
工单系统的搜索API
公共参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| method | string | y | api接口名称 |
| app_key | string | y | ezbuy分配给应用的AppKey |
| sign_method | string | y | 签名摘要算法,可选值:hmac,md5 |
| sign | string | y | api输入参数的签名结果 |
| timestamp | string | y | 时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8。ezbuy api服务端允许客户端请求的最大时间误差为10分钟 |
| version | string | y | api协议版本,可选值:1.0 |
请求参数
| 名称 | 类型 | 是否必须 | 示例值 | 限制 | 描述 |
|---|---|---|---|---|---|
| issue_number | string | n | 25374807059070976-4 | 工单编号,精确搜索 | |
| order_number | string | n | 25374807059070976-4 | 订单编号,精确搜索 | |
| issue_status | number | n | 3 | 工单状态码,不填时,表示all | |
| start_create_date | string | n | 2015-01-01 12:00:00 | 创建起始时间的时间戳, 格式为yyyy-MM-dd HH:mm:ss | |
| end_create_date | string | n | 2015-01-01 12:00:00 | 创建结束时间的时间戳, 格式为yyyy-MM-dd HH:mm:ss | |
| start_message_date | string | n | 2015-01-01 12:00:00 | 留言更新起始时间的时间戳,格式为yyyy-MM-dd HH:mm:ss | |
| end_message_date | string | n | 2015-01-01 12:00:00 | 留言更新消结束时间的时间戳,格式为yyyy-MM-dd HH:mm:ss | |
| fields | string | y | status,product_name | 需返回的字段列表;可选值为 issue 数据结构中定义的字段,多个字段用“,”分隔。issue_number默认强制返回 | |
| page_no | number | n | 33 | 当前页码,默认值为1 | |
| page_size | number | n | 99 | 每页条数,每页返回最多返回100条,默认值为10 |
备注:时间区间相关字段的差值不能大于 30 天
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| request_id | string | 92128f6e-daf3-11e7-a003-f45c89aebcfb | 请求id |
| status | RespCode | 接口响应状态 | |
| total_count | number | 匹配总记录数 | |
| result | Issue[] | 匹配工单列表 |
响应示例
{
"request_id":"92128f6e-daf3-11e7-a003-f45c89aebcfb",
"status": {
"code": "E0",
"message": "success"
},
"data": {
"total_count": 1,
"result": [
{
"issue_number": "2018041900542",
"order_number": "25352806709854208-1",
"issue_type": "退货申请",
"issue_status": 1,
"create_date": "2015/01/01 12:00:00",
"update_date": "2015/01/01 12:00:00",
"complate_date": "2015/01/01 12:00:00",
"issue_sku": {
"sku_id": 783783,
"quantity": 1
},
"replies": [
{
"username": "ezbuy",
"reply_message": "test",
"reply_message": "2015-01-01 12:00:00",
}
]
}
]
}
}
错误码
| CODE | MESSAGE | DETAIL |
|---|---|---|
| E93 | invalid issue number | {issue_number} is not valid |
| E94 | invalid issue status | {issue_status} is not valid |
| E95 | invalid timestamp difference | {date} is out of timestamp difference limit |