目录
订单查询支持两种方式
请求数据格式(指定账号)
请求头示例
数据格式说明
返回数据格式(指定账号)
返回头示例
数据格式说明
不同页面层级各自有什么订单数据
请求数据格式(指定订单编号)
请求头示例
返回数据格式(指定订单编号)
特别提醒
返回头示例
数据格式说明
通过代码方式获取自己下单的数据
订单查询支持两种方式
- 查询指定账号下的订单(按时间、按状态)
- 根据提供的订单编号查询订单
请求数据格式(指定账号)
客户端往服务器端发送请求
请求头示例
请求时带上如下信息
- 多多昵称
- 多多号
- 是否已登录
- 如果之前有任务,带上任务执行结果,比如订单数据
POST http://localhost:3001/pdd-api/request HTTP/1.1
Host: localhost:3001
Connection: keep-alive
Content-Length: 25
Accept: application/json, text/javascript, */*; q=0.01
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.114 Safari/537.36
Content-Type: application/json; charset=UTF-8
Origin: https://happ
Sec-Fetch-Site: cross-site
Sec-Fetch-Mode: cors
Sec-Fetch-Dest: empty
Accept-Encoding: gzip, deflate, br
Accept-Language: zh-CN,zh;q=0.9
{
"duoduoNick": "FlyingEagle",
"duoduoId": "948491937201",
"isLogin": true,
"orders": [
{
"actualFee": 0,
"addressInfo": "安徽省**市*县**镇",
"checkoutUrl": "https://mobile.yangkeduo.com/order_checkout.html?sku_id=726807566419&group_id=44617179213&goods_id=192927793688&goods_number=1",
"createTime": -421640576,
"detailUrl": "https://mobile.yangkeduo.com/order.html?order_sn=230411-670653520720897",
"goodsType": 1,
"groupSuccessTime": "",
"latestLogistics": "2023-04-11 19:43:02, 运输中 预计后天送达 | 中通快递:【天津市】快件离开【天津武清南部】已发往【天津中转部】",
"logisticsCompany": "中通快递",
"logisticsNumber": "78334***254667",
"logisticsStatus": "运输中",
"logisticsStatusCode": "DEPARTURE",
"nick": "FlyingEagle",
"num": 0,
"orderId": "230411-670653520720897",
"orderTime": "2023-04-11 11:15:22",
"originalTotal": 408,
"postFee": "(确认收货后自动付款¥408)",
"postmanContact": "",
"postmanName": "",
"productId": "192927793688",
"productPic": "https://img.pddpic.com/mms-material-img/2023-02-16/7982b1ae-d219-486f-91a5-40bd9a0ea86a.jpeg",
"productTitle": "永久牌自行车女单车轻便上班骑通勤24寸26代步学生大人男成年成人",
"productUrl": "https://mobile.yangkeduo.com/goods.html?goods_id=192927793688",
"quantity": 1,
"realPrice": 408,
"receiveTime": "",
"shippingTime": "2023-04-11 16:32:16",
"shopName": "永久赛文众创专卖店",
"skuId": "726807566419",
"skuInfo": "单速顶配版-复古黄,26寸【适合:160-180cm】",
"srcOrderId": "",
"status": 0,
"tradeStatus": "待收货"
}
],
"extra": null
}
数据格式说明
duoduoNick | 拼多多昵称 | 服务器端可以用来区分当前请求来源 |
duoduoId | 多多号 | 服务器端可以用来区分当前请求来源 |
isLogin | 是否已登录 | 结合昵称与多多号以及是否登录 决定是否可以向当前账号下发任务 |
extra | 附加内容 | 返回数据时携带 服务器端可以自定义的部分,客户端会原封不动的返回 |
orders | 查询到的订单数组 | 返回数据时携带 不是每次都会发送这个字段 |
返回数据格式(指定账号)
服务器端往客户端返回数据
按时间范围,按订单类型查询订单
返回头示例
查询指定账号下的订单
订单类型:全部
时间范围:2023年4月10号 19:56:00 -- 2023年4月11号 19:56:00
HTTP/1.1 200 OK
Content-Length: 273
Last-Modified: Sat, 18 Mar 2023 12:13:57 GMT
Cache-Control: max-age=0
Content-Type: application/json; charset=utf-8
Date: Mon, 20 Mar 2023 00:17:53 GMT
Connection: keep-alive
Keep-Alive: timeout=5
{
"success": 1,
"errcode": "",
"errmsg": "",
"order_query": {
"extra": null,
"params": {
"type": 0,
"dateBegin": 1681127760,
"dateEnd": 1681214160
},
"pageLevel": {
"orderDetail": false,
"logisTrack": true
}
}
}
数据格式说明
success | 请求是否成功 | 1:表示成功;0:表示失败,如果当前没有需要webcrawl执行的任务,就填写0 |
order_query | 订单查询任务 | |
params | 参数 | 查询买家订单 只针对某拼多多账号下的订单 |
extra | 服务器端自定义的数据,webcrawl会在返回中完整携带 | 可以用于server端识别任务 |
type | 订单类型 | 0:全部类型 1:待付款 2:已付款待发货 3:卖家已发货,待买家收货 4:待评价 5:待分享 |
dateBegin | 下单日期起始时间点 | 需要与dateEnd一起使用,如果没有提供表示全部时间范围内的订单 举例:1681127760 (2023年4月10号 19:56:00) |
dateEnd | 下单日期结束时间点 | 需要与dateBegin一起使用,如果没有提供表示全部时间范围内的订单 举例:1681214160 (2023年4月11号 19:56:00) |
pageLevel | 订单数据页面层级 | 当前支持页面层级 orderList:订单列表页(始终为true) orderDetail:订单详情页(默认为false) logisTrack:物流跟踪页(默认为false) 说明:如果不提供pageLevel, 默认只读取orderList |
不同页面层级各自有什么订单数据
请求数据格式(指定订单编号)
请求头示例
携带了查询结果
POST /pdd-api/request HTTP/1.1
Host: localhost:3001
Connection: keep-alive
Content-Length: 1587
Pragma: no-cache
Cache-Control: no-cache
Accept: application/json, text/javascript, */*; q=0.01
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.114 Safari/537.36
Content-Type: application/json; charset=UTF-8
Origin: https://happ
{
"duoduoNick": "FlyingEagle",
"isLogin": false,
"orders": [
{
"orderId": "230411-670653520720897",
"token": "HJIE7E5NJTMVDE****5P2JHIC6T7UETY46MV7VYCOIAAPQON3Q113810e",
"pddAccount": "F***agle",
"orderStatus": "待收货",
"productTitle": "永久牌自行车女单车轻便上班骑通勤24寸26代步学生大人男成年成人",
"productId": "192927793688",
"createTime": 1681182922,
"logisticsNumber": "78334****54667",
"mall": {
"id": "428329244",
"logo": "https://img.pddpic.com/goods_mms/2022-08-23/f9ad2d5a-f996-4334-8bd7-d3deba108a8d_suffix.jpeg",
"mallName": "永久赛文众创专卖店",
"mallUrl": "mall_page.html?mall_id=428329244&msn=4qpdgt7rajnvo3vvb47h5nb4gi_axbuy&has_decoration=1&goods_id=192927793688"
},
"logisticsStatusCode": "OUT_CABINET",
"logisticsStatus": "已签收",
"latestLogistics": "2023-04-13 14:05:13, 已签收 | 中通快递:已签收, 签收人凭取货码签收, 如有疑问请电联:(1805****611/18056****11),您的快递已经妥投,感谢使用中通快递,期待再次为您服务!"
},
{
"orderId": "230410-569486898091057",
"token": "6FHNSWI3PNFBCSA7TCZYOXA35&&&&O3GFRO5W6UZLL2LQCH3F3Q110216a",
"pddAccount": "*******州店",
"orderStatus": "待收货",
"productTitle": "适用苹果PD快充数据线20W充电器套装iPhone12/11pro8p/xs/x充电线",
"productId": "283631671882",
"createTime": 1681115831,
"logisticsNumber": "462871****602468",
"mall": {
"id": "930798878",
"logo": "http://t16img.yangkeduo.com/pdd_ims/img_check/v2/FFFFFF2D6EE40720200112151719496/57f83a8a0ead4b11971c0f4d0150470a.png",
"mallName": "GOLEVEL数码官方旗舰店",
"tagImage": "https://funimg.pddpic.com/d66b3a03-0041-482b-82c7-ab9d5f9f1603.png",
"tagList": [
{
"logoUrl": "https://funimg.pddpic.com/d66b3a03-0041-482b-82c7-ab9d5f9f1603.png",
"logoHeight": 48,
"logoWidth": 90
}
],
"mallUrl": "mall_page.html?mall_id=930798878&msn=gohma5q5qakdueacene4nz6hky_axbuy&goods_id=283631671882"
},
"logisticsStatusCode": "SIGN",
"logisticsStatus": "已签收",
"latestLogistics": "2023-04-13 18:27:21, 已签收 | 韵达快递:【承德市】您的快件已签收,签收人:同事,如有问题请电联快递员:**文(18521**9515),投诉电话:0311-66850725。"
}
]
}
返回数据格式(指定订单编号)
同一批查询的订单可以不是同一个账号下的,软件会自动匹配
特别提醒
多账号下的订单查询时,只适用于已注册的账号
返回头示例
Cache-Control: max-age=0
Connection: keep-alive
Content-Length: 344
Content-Type: application/json; charset=utf-8
Date: Wed, 12 Apr 2023 03:50:32 GMT
Keep-Alive: timeout=5
Last-Modified: Wed, 12 Apr 2023 03:50:22 GMT
{
"success": 1,
"errcode": "",
"errmsg": "",
"order_query": {
"extra": null,
"orderList": [
{
"orderId": "230411-670653520720897"
},
{
"orderId": "230410-569486898091057"
}
],
"pageLevel": {
"orderDetail": false,
"logisTrack": true,
"afterSale": false
}
}
}
数据格式说明
orderList | 待查询的订单列表 | |
orderId | 查询列表中的一个订单编号 | |
pageLevel | 订单数据页面层级 | 当前支持页面层级 orderList:订单列表页(始终为true) orderDetail:订单详情页(默认为false) logisTrack:物流跟踪页(默认为false) afterSale:售后详情页(默认为false,只有售后单才有该层页面) 说明:如果不提供pageLevel, 默认只读取orderList |