二、订单查询接口
2.1 接口请求
- 请求方式:Post
- 接收类型:form-data
调用频率说明
频率限制
建议每个订单每天调用次数 不超过10次,如果调用频率太大占用资源,我方将进行拦截(每分钟不能超过200次)。
重要提醒
已撤单、审核不通过、已取消、已结算、无法结算,接口返回这5个状态之后,请不要再继续调用查询接口,因为后续订单状态不会再有变化。
2.2 接口地址
https://haokaopenapi.lot-ml.com/api/order/GetOrderInfo
2.3 请求参数
| 参数名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| user_id | String | Y | 代理在172号卡登录账号 |
| Timestamp | String | Y | 时间戳(长度10位,与服务器时间不能超过5分钟) |
| DownOrderID | String | Y | 下游订单id(对接接口方订单ID),不能重复 |
| user_sign | String | Y | MD5加密(32位小写) |
MD5加密规则
Md5("DownOrderID=" + DownOrderID + "&Timestamp=" + Timestamp + "&user_id=" + user_id + secret)- Secret(秘钥)追加到最后
- 前面的参数需按自然顺序排列
- 参考 MD5在线加密工具
2.4 返回参数
2.4.1 成功返回
json
{
"data": {
"orderNo": "mlkj230412165954****",
"downOrderNo": "4278****",
"name": "田**",
"expressName": "京东",
"expressCode": "JDV01098242****",
"orderStatus": "已发货",
"createTime": "2023-04-12 16:59:54",
"thirdPhone": "1309554****",
"remark": "[已发货]",
"cardStatus": "未激活",
"activationTime": "",
"isFirstCharge": "0",
"firstCharge": ""
},
"code": 0,
"message": "成功",
"errs": null
}2.4.2 错误返回
json
{
"code": -1,
"message": "订单不存在",
"errs": null
}2.5 订单状态说明
| 状态 | 说明 |
|---|---|
| 待处理 | 下单成功,我方尚未提交给运营商 |
| 已提运营商 | 我方已提交给运营商 |
| 已发货 | 运营商已发货 |
| 已完成 | 可按已发货处理,不是所有订单都有此状态 |
| 已撤单 | 我方提交运营商失败 |
| 审核不通过 | 运营商审核失败或用户取消订单 |
| 已取消 | 用户取消订单 |
| 已结算 | 订单已结算,佣金已到代理账户 |
| 无法结算 | 未满足结算要求,结算失败 |
