拼多多开放平台订单信息查询接口【pdd.order.basic.list.get订单基础信息列表查询接口(根据成交时间)】代码对接教程如下:
1.公共参数
参数名称 | 参数类型 | 是否必填 | 参数描述(接口代码教程wx19970108018) |
---|---|---|---|
type | String | 必填 | API接口名称 (必须以GET方式拼接在URL中,点击获取请求key和secret) |
client_id | String | 必填 | POP分配给应用的client_id |
access_token | String | 非必填 | 通过code获取的access_token |
timestamp | String | 必填 | UNIX时间戳,单位秒,需要与拼多多服务器时间差值在10分钟内 |
data_type | String | 非必填 | 响应格式,即返回数据的格式,JSON或者XML(二选一),默认JSON,注意是大写 |
version | String | 非必填 | API协议版本号,默认为V1,可不填 |
sign | String | 必填 | API输入参数签名结果,签名算法参考开放平台接入指南第三部分底部。 |
2.请求参数说明
参数接口 | 参数类型 | 是否必填 | 说明 |
---|---|---|---|
end_confirm_at | INTEGER | 必填 | 必填,成交时间结束时间的时间戳,指格林威治时间 1970 年 01 月 01 日 00 时 00 分 00 秒(北京时间 1970 年 01 月 01 日 08 时 00 分 00 秒)起至现在的总秒数 PS:开始时间结束时间间距不超过 24 小时 |
order_status | INTEGER | 必填 | 发货状态,1:待发货,2:已发货待签收,3:已签收 5:全部 |
page | INTEGER | 必填 | 返回页码 默认 1,页码从 1 开始 PS:当前采用分页返回,数量和页数会一起传,如果不传,则采用 默认值 |
page_size | INTEGER | 必填 | 返回数量,默认 100。最大 100 |
refund_status | INTEGER | 必填 | 售后状态 1:无售后或售后关闭,2:售后处理中,3:退款中,4: 退款成功 5:全部 |
start_confirm_at | INTEGER | 必填 | 必填,成交时间开始时间的时间戳,指格林威治时间 1970 年 01 月 01 日 00 时 00 分 00 秒(北京时间 1970 年 01 月 01 日 08 时 00 分 00 秒)起至现在的总秒数 |
trade_type | INTEGER | 非必填 | 订单类型 0-普通订单 ,1- 定金订单 |
use_has_next | BOOLEAN | 非必填 | 是否启用has_next的分页方式,如果指定true,则返回的结果中不包含总记录数,但是会新增一个是否存在下一页的的字段,通过此种方式获取增量交易,效率在原有的基础上有80%的提升。 |
3.请求示例(CURL、PHP 、PHPsdk 、Java 、C# 、Python…)
- package com.pdd.pop.sdk.http.demo;
-
- import com.pdd.pop.sdk.common.util.JsonUtil;
- import com.pdd.pop.sdk.http.api.pop.request.PddOrderBasicListGetRequest;
- import com.pdd.pop.sdk.http.api.pop.response.PddOrderBasicListGetResponse;
- import com.pdd.pop.sdk.http.PopClient;
- import com.pdd.pop.sdk.http.PopHttpClient;
-
- public class PopClientDemo {
-
- public static void main(String[] args) throws Exception {
-
- String clientId = "your clientId";
- String clientSecret = "your clientSecret";
- String accessToken = "your accessToken";
- PopClient client = new PopHttpClient(clientId, clientSecret);
-
- PddOrderBasicListGetRequest request = new PddOrderBasicListGetRequest();
- request.setEndConfirmAt(1);
- request.setOrderStatus(1);
- request.setPage(1);
- request.setPageSize(1);
- request.setRefundStatus(1);
- request.setStartConfirmAt(1);
- request.setTradeType(1);
- request.setUseHasNext(false);
- PddOrderBasicListGetResponse response = client.syncInvoke(request, accessToken);
- System.out.println(JsonUtil.transferToJson(response));
- }
- }
4.响应示例
- {
- "order_basic_list_get_response": {
- "has_next": false,
- "order_list": [
- {
- "cat_id_1": 1,
- "cat_id_2": 1,
- "cat_id_3": 1,
- "cat_id_4": 1,
- "confirm_time": "1",
- "delivery_home_value": 1.0,
- "delivery_install_value": 1.0,
- "discount_amount": 1.0,
- "goods_amount": 1.0,
- "home_delivery_type": 1,
- "home_install_value": 1.0,
- "is_lucky_flag": 1,
- "item_list": [
- {
- "goods_count": 1,
- "goods_id": "1",
- "goods_img": "1",
- "goods_name": "1",
- "goods_price": 1.0,
- "goods_spec": "1",
- "outer_goods_id": "1",
- "outer_id": "1",
- "sku_id": "1"
- }
- ],
- "order_sn": "1",
- "order_status": 1,
- "pay_amount": 1.0,
- "platform_discount": 1.0,
- "postage": 1.0,
- "refund_status": 1,
- "risk_control_status": 0,
- "seller_discount": 1.0,
- "step_order_info": {
- "advanced_paid_fee": 1.0,
- "step_discount_amount": 1.0,
- "step_paid_fee": 1.0,
- "step_trade_status": 1
- },
- "trade_type": 1,
- "updated_at": "1"
- }
- ],
- "total_count": 1
- }
- }