拼多多买家订单API

目录

订单查询支持两种方式

请求数据格式(指定账号)

请求头示例

数据格式说明

返回数据格式(指定账号)

返回头示例

数据格式说明

不同页面层级各自有什么订单数据

请求数据格式(指定订单编号)

请求头示例

返回数据格式(指定订单编号)

特别提醒

返回头示例

数据格式说明


通过代码方式获取自己下单的数据

订单查询支持两种方式

  • 查询指定账号下的订单(按时间、按状态)
  • 根据提供的订单编号查询订单

请求数据格式(指定账号)

客户端往服务器端发送请求

请求头示例

请求时带上如下信息

  • 多多昵称
  • 多多号
  • 是否已登录
  • 如果之前有任务,带上任务执行结果,比如订单数据
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

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值