接口地址:
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 |
请求方式不对 |