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