接口地址:
http://api.web.ecapi.cn/pinduoduo/getOauthIncrementOrderList
接口实例:
http://api.web.ecapi.cn/pinduoduo/getOauthIncrementOrderList?apkey=登录会员中心查看&start_update_time=1540736728&end_update_time=1543415128&pdname=xxxxx
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围:
付费会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先
添加IP白名单 (
IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
-
使用说明
-
-
请求参数
-
| 参数 |
类型 |
请求参数参考值 |
是否必须 |
说明 |
| apkey |
String |
xxxxxxx |
是 |
用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
| start_update_time |
Number |
1540736728 |
是 |
订单开始时间,时间戳 |
| end_update_time |
Number |
1543415128 |
是 |
订单结束时间,时间戳 |
| pdname |
String |
xxxxx |
是 |
在本平台授权后的拼多多用户名 |
| page_size |
Number |
10 |
|
每页中数据的数量 |
| page |
Number |
1 |
|
第几页 |
| pid |
String |
60000_2000 |
|
推广位ID |
-
返回参数
-
| 返回参数 |
类型 |
参数说明 |
扩展说明 |
| total_count |
Number |
订单总量 |
|
| order_list |
Json |
订单列表 |
|
| ├ total_count |
String |
订单总量 |
– |
| ├ p_id |
String |
推广位ID |
– |
| ├ order_sn |
String |
订单号 |
– |
| ├ goods_thumbnail_url |
String |
商品缩略图 |
– |
| ├ goods_id |
String |
商品ID |
– |
| ├ goods_name |
String |
商品名 |
– |
| ├ goods_quantity |
String |
购买商品的数量 |
– |
| ├ goods_price |
String |
订单中sku的单件价格 |
单位:分 |
| ├ order_amount |
String |
实际支付金额 |
单位:分 |
| ├ order_create_time |
String |
订单生成时间 |
UNIX时间戳 |
| ├ promotion_rate |
String |
佣金比例 |
千分比 |
| ├ promotion_amount |
String |
佣金金额 |
单位为分 |
| ├ order_status |
String |
订单状态 |
-1 未支付; 0-已支付;1-已成团;2-确认收货;3-审核成功;4-审核失败(不可提现);5-已经结算;8-非多多进宝商品(无佣金订单);10-已处罚 |
| ├ order_status_desc |
String |
订单状态描述 |
已成团 |
| ├ order_modify_at |
String |
最后更新时间 |
UNIX时间戳 |
| ├ order_group_success_time |
String |
成团时间 |
UNIX时间戳 |
| ├ order_pay_time |
String |
支付时间 |
UNIX时间戳 |
| ├ order_verify_time |
String |
审核时间 |
UNIX时间戳 |
| ├ order_receive_time |
String |
订单确认签收时间 |
UNIX时间戳 |
| ├ type |
String |
订单来源 |
0—单品(领券页)推广 1—红包活动推广 2—领券页底部推荐 |
| ├ custom_parameters |
String |
自定义参数 |
标志订单来源于哪个自定义参数 |
| ├ subsidy_duo_amount_ten_million |
Number |
官方活动给渠道的收入补贴金额,不允许直接给下级代理展示 |
单位为分 |
| ├ sep_market_fee |
Number |
直播间推广佣金 |
|
| ├ order_settle_time |
Number |
结算时间 |
|
| ├ mall_id |
Number |
店铺id |
|
| ├ auth_duo_id |
Number |
多多客工具id |
|
| ├ mall_name |
String |
店铺名称 |
|
| ├ subsidy_type |
Number |
订单补贴类型 |
0-非补贴订单,1-千万补贴,2-社群补贴,3-多多星选,4-品牌优选,5-千万神券 |
| ├ sep_rate |
Number |
直播间推广佣金比例 |
|
| ├ sep_parameters |
String |
直播间推广自定义参数 |
|
| ├ share_rate |
Number |
招商分成服务费比例 |
千分比 |
| ├ share_amount |
Number |
招商分成服务费金额 |
单位为分 |
| ├ sep_pid |
String |
直播间订单推广位 |
|
| ├ scene_at_market_fee |
Number |
场景工具商佣金 |
|
| ├ zs_duo_id |
Number |
招商多多客id |
|
| ├ subsidy_duo_amount_level |
Number |
等级补贴给渠道的收入补贴,不允许直接给下级代理展示,单位为分 |
|
| ├ is_direct |
Number |
是否直推 |
1表示是,0表示否 |
| ├ subsidy_amount |
Number |
优势渠道专属商品补贴金额 |
单位为分。针对优质渠道的补贴活动,指定优势渠道可通过推广该商品获取相应补贴。补贴活动入口:[进宝网站-官方活动] |
| ├ cpa_new |
Number |
是否是 cpa 新用户 |
1表示是,0表示否 |
| ├ batch_no |
String |
结算批次号 |
|
| ├ red_packet_type |
String |
超级红包补贴类型 |
0-非红包补贴订单,1-季度新用户补贴 |
| ├ activity_tags |
Json |
商品活动标记数组 |
例:[4,7],4-秒杀 7-百亿补贴等 |
| ├ group_id |
String |
成团编号 |
|
| ├ goods_sign |
String |
goodsSign是加密后的goodsId |
goodsId已下线,请使用goodsSign来替代。需要注意的是:推广链接带有goodsSign信息时,订单会返回原goodsSign;反之,会生成新的goodsSign返回。 |
| ├ no_subsidy_reason |
String |
非补贴订单原因,例如:"商品补贴达上限","达到单个用户下单上限","非指定落 |
|
-
Json返回示例
-
{"code":200,"data":{"order_list":[],"total_count":0},"msg":"订单获取成功"}
-
code/http_status说明
-
| code/http_status |
说明 |
| 200 |
数据获取成功 |
| -1 |
数据获取失败 |
| 401 |
IP没有添加白名单 |
| 429 |
访问次数超限 |
| 403 |
关键参数丢失 |
| 405 |
请求方式不对 |