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