订单状态查询接口
接口地址
https://activity.m.duiba.com.cn/gaw/supply/queryOrder
接口支持http或https协议访问,响应内容中链接的协议头也会自适应转换。
注意:该接口需开发者进行轮询获取最新状态(建议轮询时间为:8h/次)
请求方式:get
请求参数
参数 | 类型 | 是否必填 | 限制长度 | 描述 |
---|---|---|---|---|
appKey | string | Y | 255 | 应用唯一标注 |
timestamp | string | Y | 20 | 1970.1.1开始的毫秒数 |
sign | string | Y | 255 | 签名(详见签名规则) |
thirdOrderNum | string | Y | 255 | 第三方订单号 |
响应参数
参数参数 | 类型 | 是否必填 | 限制长度 | 描述 |
---|---|---|---|---|
success | boolean | Y | 是否成功 | |
code | string | Y | 255 | 参见‘响应码明细表’ |
desc | string | Y | 255 | 参见‘响应码明细表’ |
timestamp | string | Y | 20 | 系统时间戳 |
data | object | Y | 255 | 详见‘data明细表’ |
data明细表
参数参数 | 类型 | 是否必填 | 限制长度 | 描述 |
---|---|---|---|---|
thirdOrderNum | string | Y | 255 | 第三方订单号 |
orderNum | string | Y | 255 | 兑吧订单号 |
orderStatus | string | Y | 255 | 订单状态 1:处理中 2:待发货 3:成功(已发货)4:失败 |
failReason | string | N | 255 | 错误原因(系统异常,稍后再试、扣app余额失败,请再试试、兑换券已经用完、商品扣库存失败,实物商品取消发货返回运营填写的取消原因) |
expressNo | string | N | 255 | 快递单号 |
expressCompanyName | string | N | 255 | 快递名称 |
link | string | N | 255 | 优惠券跳转链接 |
code | string | N | 255 | 优惠券券码 |
account | string | N | 255 | 卡密类充值卡号 |
password | string | N | 255 | 卡密类充值密码 |
overdue | long | N | 20 | 券码券有效期,时间戳(1970-01-01开始的时间戳,毫秒为单位) |
cardVerifyEndTime | string | N | 20 | 链接券领取到期时间(格式为:yyyyMMdd HH:mm:ss) |
cardVerifyStatus | int | N | 10 | 卡券核销状态(0:已领取未核销 1:已核销,如果为空是未领取) |
备注:
“link”与“code”,“account”与“password”为配套参数
“link”和“code”有返回值的情况下,后者为null;
“account”和“password”有返回值的情况下,前者为null;
响应码明细表
code | desc |
---|---|
0000000000 | 成功 |
9999999 | 发生系统错误 |
1100001 | appKey不能为空 |
1100002 | appKey错误 |
1100003 | 签名验证失败 |
1100013 | 订单不存在 |
1100014 | 签名不能为空 |
1100015 | 时间戳不能为空 |
1100016 | 请求已过期 |
请求示例
https://activity.m.duibatest.com.cn/gaw/supply/queryOrder?appKey=4Z44cH5Gv1Fgp9oHbjddU3Q6THe1&sign=F274580EC86991B84980776C5EF9962C×tamp=1691115113000&thirdOrderNum=test10018
响应示例
{
"success":true,
"code":"0000000000",
"desc":"OK",
"timestamp":1561393862580,
"data":{
"thirdOrderNum":"12322222",
"orderNum":"123123123",
"orderStatus":1,
"failReason":"库存不足",
"expressNo":"11111110000",
"expressCompanyName":"圆通快递",
"link":"http:spring.io",
"code":"DWcidneXSAW",
"account":"asdfgh",
"password":"NaDX2i",
"overdue":1561393862580
}
}