get-order-list (获取订单数据)

公共参数

接口地址 http://openapi.mabangerp.com
提交方式 POST
HTTP Header Content-Type: application/json
Authorization: 签名
签名:HTTP Body所有入参的字符串JSON格式和开发者密钥传递给HMAC-SHA256哈希算法来计算签名
HMAC签名函数的输出是二进制字符串。这需要进行十六进制编码以生成签名字符串。
例如:
HTTP Body所有入参的字符串JSON:{"developerId":10000,"timestamp":1592478495,"action":"get-order-list"}
开发者密钥:c5540d632392451a0ad89721d0705ce24cb2
生成的签名: ae6dbd7743e05cafb8b3b17b7f11d4379a2392a8da119acf66082a3262651f96
HTTP Body HTTP正文应仅包含序列化的JSON字符串(所有入参的数据)
请求频率 每分钟300个请求, 在响应头中可查看(限制X-RateLimit-Limit, 剩余X-RateLimit-Remaining)

公共请求参数:

名称 类型 必须 描述
developerId String 开发者账号(需联系客服开通)
timestamp String Unix 时间戳;接口有效时间半小时
action String 方法:get-order-list
调用限制 订单查询接口必须传时间范围参数(updateTimeStart/paidtimeStart/createDateStart/expressTimeStart)才可以获取数据,上午7:00~19:00时间范围只支持近一天数据查询,其余时间只允许时间范围为一天的数据,按天获取数据
例如:
今天是2019-08-11 12:33:13,上午7:00~19:00时间只能查2019-08-10 00:00:00~2019-08-11 12:33:13范围订单
其余时间获取,开始时间和结束时间范围间隔不能超过24小时,如:2019-08-01 12:00:00~2019-08-02 12:00:00

公共响应参数:

名称 类型 必须 描述
code String 请求失败返回的错误码
message String 请求失败返回的错误信息

请求参数

名称
类型
必须
示例值
描述
status
String
false
1
1.待处理 2.配货中 3.已发货 4.已完成 5.已作废 6.所有未发货 7.所有非未发货 默认配货中订单
platformOrderIds
String
false
订单编号,多个用英文逗号隔开,最大支持10个
shopName
String
false
店铺名称
updateTimeStart
DateTime
false
2019-08-11 12:33:13
最后修改时间开始时间
updateTimeEnd
DateTime
false
2019-08-11 12:33:13
最后修改时间结束时间
paidtimeStart
DateTime
false
2019-08-11 12:33:13
付款时间开始时间
paidtimeEnd
DateTime
false
2019-08-11 12:33:13
付款时间结束时间
createDateStart
DateTime
false
2019-08-11 12:33:13
创建时间开始时间
createDateEnd
DateTime
false
2019-08-11 12:33:13
创建时间结束时间
expressTimeStart
DateTime
false
2019-08-11 12:33:13
发货时间开始时间
expressTimeEnd
DateTime
false
2019-08-11 12:33:13
发货时间结束时间
canSend
String
false
1.正常订单 2.异常订单 3.全部订单 默认正常订单
page
Int
false
1
当前页数,默认1

响应参数

名称
类型
示例值
描述
code
String
0000
999失败;000成功
message
String
新增成功
描述信息
pageCount
String
000
总页数
dataCount
String
000
总条数
data
JSON
多维
数据集合json格式

异常示例

 {
    "code":999,
    "message":失败原因
}
 

错误码解释

错误码 错误消息
000 成功
999 失败描述