/dingdan/liebiao(获取订单列表)
请求地址:
| 示例地址 | 描述 |
| https://{xxx.com}/dingdan/liebiao | 地址中的xxx.com为示例,请在会员中心的 资料设置 中查看ApiHost。 |
公共请求参数:
| 名称 | 类型 | 必须 | 描述 |
| uid | Number | 是 | 账号UID,在会员中心的 资料设置 中查看。资料中的ID号包括了站点ID和账号UID,例如:111-10088,其中111是站点ID,10088是账号UID,请勿混淆。 |
| t | Number | 是 | 秒级时间戳 |
| sign | String | 是 | 签名( 查看签名算法 ) |
请求参数:
| 名称 | 类型 | 必须 | 描述 |
| uuid | String / uuid[] | 否 | 下单时传的唯一ID号,传字符串只查1单,传数组批量查询。示例 [ "xxx-01", "xxx-02" ] |
| times | time[] | 否 | 筛选订单下单时间区间,示例 [ "2023-12-11 00:00:00", "2023-12-17 00:00:00" ] ,为空时查询最近7天的订单。 |
| batch | Number | 否 | 下单批次,在下单时传的相关参数。 |
| status | Number | 否 | 订单状态,1.正常订单; 2.已退款; 3.退款中; 4.异常订单 |
| wuliu | Number | 否 | 物流状态,99.无物流; 1.运输中; 2.已签收; 3.异常 |
| order_id | String | 否 | 店铺中的订单号 |
| express | String | 否 | 快递单号 |
| page | Number | 是 | 页码 |
| limit | Number | 是 | 每一页返回订单数量 |
响应参数:
{
"code": 200,
"msg": "success",
"data": {
"success": true,
"list": [
{
// 仓库信息
"cangku": {
"ckid": 103,
"name": "广州大源",
"logo": "xxx.png"
},
// 快递信息
"kuaidi": {
"kdid": 103,
"name": "韵达快递",
"icon": "xx.png"
},
// 电商平台
"shop_type": {
"name": "拼多多",
"icon": "gyl-pinduoduo",
"type": "pdd",
"id": 3
},
"message": [], // 错误提示
"create_time": "08-08 08:08:08", // 下单时间
"goods_image": "xxx.png", // 商品图片
"oid": 1000000088, // 订单号
"uuid": xxx-xxx-xxx, // 唯一ID号
"ckid": 103, // 仓库ID
"pzid": 888, // 快递配置信息
"order_id": "", // 店铺中的订单ID
"price": "8.88", // 下单单价
"user_shop_name": "", // 店铺名称
"express_number": "463290198888888", // 快递单号
"sender_name": "xx", // 发件-姓名
"sender_mobile": "18812345678", // 发件-号码
"sender_province": "广东省", // 发件-省份
"sender_city": "广州市", // 发件-城市
"sender_district": "白云区", // 发件-地区
"sender_address": "大源镇大源东路63号", // 发件-街道
"receiver_name": "收件人", // 收件-姓名
"receiver_mobile": "18812345678", // 收件-号码
"receiver_province": "湖北省", // 收件-省份
"receiver_city": "孝感市", // 收件-城市
"receiver_district": "大悟县", // 收件-地区
"receiver_town": "", // 收件-街道
"receiver_address": "城关镇幸福路11号", // 收件-门牌
"goods_id": 100341, // 商品ID
"sku_id": 800078, // 商品SkuID
"goods_title": "商品标题", // 商品标题
"sku_name": "韩版黑【1只】", // 商品Sku名称
"exp_step": 0, // 物流状态:0.无物流 1.途中 2.签收 3.异常
"status": 1, // 订单状态:1.正常 2.已退款 3.退款中 4.黑名单 5.异常
"goods_list": [] // 多订单下的商品
}
],
"isOld": false // 无用参数
}
}
PHP示例代码:
function test_api(){
$url = 'http://xxx.com/dingdan/liebiao';
$uid = '188888';
$mobile = '18899999999';
$apikey = '8d2e89203dd3b2d1cbad6e853101da99';
$t = time();
$post = [];
$post['t'] = $t;
$post['uid'] = $uid;
$post['sign'] = md5(md5(strtolower($apikey).$mobile.$uid.$t));
$post['uuid'] = [ "xxx-01", "xxx-02" ];
$post['page'] = 1;
$post['limit'] = 20;
$resp = self::sendPost( $url, $post, 'POST', [] );
return json($resp);
}