待发货订单查询接口
背景
开发者可通过该接口查询兑吧后台产生的开发者自有实物商品待发货订单,可配合自有商品批量发货接口给用户进行发货(使用该接口需找兑吧技术支持开通权限)
请求
请求方式:GET(接口数据有五分钟缓存)
请求地址:http://activity.m.duiba.com.cn/taw/openOrderApi/waitOrder
请求参数(Get请求方式传参)
参数 |
是否必须 |
参数类型 |
参数说明 |
例子 |
appKey |
yes |
string |
接口appKey,应用的唯一标识码 |
|
timestamp |
yes |
string |
1970-01-01开始的时间戳,毫秒 |
1596161518000 |
startDay |
yes |
string |
开始时间 |
2020-07-06 00:00:00 |
endDay |
yes |
string |
结束时间,时间段不能超过10天 |
2020-07-07 00:00:00 |
rowId |
yes |
string |
页码 |
1 |
max |
yes |
string |
每页返回的数量,最大不超过50 |
10 |
sign |
yes |
string |
签名,详见签名规则 |
响应参数
参数 |
参数类型 |
参数说明 |
success |
boolean |
成功/失败 |
code |
string |
响应码,参见‘异常响应码汇总表’ |
desc |
string |
说明 |
data |
object |
参见‘data明细表’ |
data明细表
参数 |
参数类型 |
参数说明 |
waitOrdersTotalCount |
long |
所有待发货订单数量 |
list |
object |
参见‘list.item明细表’ |
list.item明细表
参数 |
参数类型 |
参数说明 |
orderNum |
string |
兑吧订单号 |
orderStartTime |
string |
订单创建时间 |
partnerUserId |
string |
开发者用户 id |
appItemId |
string |
商品 appitemid |
merchantCoding |
string |
商家编码 |
title |
string |
商品名称 |
credits |
long |
用户消耗积分数 |
consumerPayPrice |
Integer |
用户实付金额(包含运费), 单位分 |
expressPrice |
Integer |
运费,单位分 |
addrName |
string |
收货人姓名 |
addrPhone |
string |
收货人手机号 |
addrProvince |
string |
省份 |
addrCity |
string |
城市 |
addrArea |
string |
区 |
addrStreet |
string |
街道 |
addrDetail |
string |
详细地址 |
响应示例
成功:
{
"success":true,
"code":"0000000",
"desc":"成功",
"data":{
"waitOrdersTotalCount":1,
"list":[
]
}
}
失败:
{
"success":false,
"code":"0100007",
"desc":"参数不能为空",
"data":null
}
异常响应码汇总表
响应吗 |
说明 |
660101 |
请求已过期 |
660102 |
时间段不能超过 10 天 |
660103 |
appKey不正确 |
660104 |
该app未授权访问 |
660105 |
签名验证失败 |
660106 |
调用成功 |
660107 |
异常错误 |
660108 |
参数错误 |
660109 |
参数不能为空 |