/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); }