接口地址:
http://api.web.ecapi.cn/pinduoduo/getRpPromUrl
接口实例:
http://api.web.ecapi.cn/pinduoduo/getRpPromUrl?apkey=登录会员中心查看&p_id_list=60005_612,60005_613&pdname=xxxx
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围:
付费会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先
添加IP白名单 (
IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
-
使用说明
-
-
请求参数
-
参数 |
类型 |
请求参数参考值 |
是否必须 |
说明 |
apkey |
String |
xxxxxxx |
是 |
用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
p_id_list |
String |
60005_612,60005_613 |
是 |
推广位列表 |
pdname |
String |
xxxx |
是 |
在本平台授权的拼多多用户名 |
channel_type |
Number |
0 |
|
营销工具类型,必填:-1-活动列表,0-红包(需申请推广权限),2–新人红包,3-刮刮卡,5-员工内购,10-生成绑定备案链接,12-砸金蛋,13-一元购C端页面,14-千万补贴B端页面,15-充值中心B端页面,16-千万补贴C端页面,17-千万补贴投票页面,18-一元购B端页面,19-多多品牌星选B端页面,20-多多品牌星选C端页面,23-超级红包,24-礼金全场N折活动B端页面,25-品牌优选B端页面,26-品牌优选C端页面;红包推广权限申请流程链接:https://jinbao.pinduoduo.com/qa-system?questionId=289 |
custom_parameters |
String |
xxxx |
|
自定义参数,为链接打上自定义标签;自定义参数最长限制64个字节;格式为: {"uid":"11111","sid":"22222"} ,其中 uid 用户唯一标识,可自行加密后传入,每个用户仅且对应一个标识,必填; sid 上下文信息标识,例如sessionId等,非必填。该json字符串中也可以加入其他自定义的key |
opt_id |
Number |
1 |
|
转盘优先展示类目 |
range_from |
Number |
xxxx |
|
转盘区间的开始值 |
range_id |
Number |
1 |
|
转盘,range_id为1表示价格(单位分), range_id为2表示商品佣金(单位千分之几) |
range_to |
Number |
xxxx |
|
转盘区间的结束值 |
amount_probability |
String |
100,200 |
|
红包金额列表,200、300、500、1000、2000,单位分。红包金额和红包抵后价设置只能二选一,默认设置了红包金额会忽略红包抵后价设置 |
dis_text |
String |
xxxx |
|
红包设置玩法,false-现金红包, true-现金券 |
not_show_background |
String |
xxxx |
|
红包推广页设置,false-红包开启页, true-红包领取页 |
diy_red_opt_id |
String |
xxxx |
|
红包优先展示类目 |
diy_red_range_from |
Number |
1 |
|
红包区间的开始值 |
diy_red_range_id |
Number |
1 |
|
红包,range_id为1表示红包抵后价(单位分), range_id为2表示佣金比例(单位千分之几) |
diy_red_range_to |
Number |
1 |
|
红包区间的结束值 |
generate_qq_app |
String |
true |
|
是否生成qq小程序 |
generate_schema_url |
String |
true |
|
是否返回 schema URL |
generate_short_url |
String |
true |
|
是否生成短链接。true-是,false-否,默认false |
generate_we_app |
String |
true |
|
是否生成小程序推广 |
-
返回参数
-
返回参数 |
类型 |
参数说明 |
扩展说明 |
url_list |
Json |
url_list |
|
├ mobile_short_url |
String |
推广移动短链接 |
|
├ mobile_url |
String |
推广移动链接 |
|
├ multi_group_mobile_short_url |
String |
推广多人团移动短链接 |
|
├ multi_group_mobile_url |
String |
推广多人团移动链接 |
|
├ multi_group_short_url |
String |
推广多人团短链接 |
|
├ multi_group_url |
String |
推广多人团链接 |
|
├ schema_url |
String |
schema的链接 |
|
├ short_url |
String |
推广短链接 |
|
├ url |
String |
推广链接 |
|
├ qq_app_info |
String |
qq小程序信息 |
|
├ ├ app_id |
String |
拼多多小程序id |
|
├ ├ banner_url |
String |
Banner图 |
|
├ ├ desc |
String |
描述 |
|
├ ├ page_path |
String |
小程序path值 |
|
├ ├ qq_app_icon_url |
String |
小程序icon |
|
├ ├ source_display_name |
String |
来源名 |
|
├ ├ title |
String |
小程序标题 |
|
├ ├ user_name |
String |
用户名 |
|
├ we_app_info |
Json |
小程序信息 |
|
├ ├ app_id |
String |
拼多多小程序id |
|
├ ├ banner_url |
String |
Banner图 |
|
├ ├ desc |
String |
描述 |
|
├ ├ page_path |
String |
小程序path值 |
|
├ ├ source_display_name |
String |
来源名 |
|
├ ├ title |
String |
小程序标题 |
|
├ ├ user_name |
String |
用户名 |
|
├ ├ we_app_icon_url |
String |
小程序icon |
|
resource_list |
Json |
resource_list |
|
├ desc |
String |
活动描述 |
|
├ url |
String |
活动地址 |
|
-
Json返回示例
-
{"code":200,"data":{"url_list":[{"multi_group_url":"https://mobile.yangkeduo.com/app.html?use_reload=1&launch_url=duo_scratch_card.html?pid=1755220_23369703&authDuoId=1755220&cpsSign=CL_200826_1755220_23369703_958397402f8d39d5e472d5047f76961f&duoduo_type=3&campaign=ddjb&cid=launch_download_roulette_","mobile_url":"https://mobile.yangkeduo.com/app.html?use_reload=1&launch_url=duo_scratch_card.html?pid=1755220_23369703&authDuoId=1755220&cpsSign=CL_200826_1755220_23369703_958397402f8d39d5e472d5047f76961f&duoduo_type=2&campaign=ddjb&cid=launch_download_roulette_","multi_group_mobile_url":"https://mobile.yangkeduo.com/app.html?use_reload=1&launch_url=duo_scratch_card.html?pid=1755220_23369703&authDuoId=1755220&cpsSign=CL_200826_1755220_23369703_958397402f8d39d5e472d5047f76961f&duoduo_type=3&campaign=ddjb&cid=launch_download_roulette_","url":"https://mobile.yangkeduo.com/app.html?use_reload=1&launch_url=duo_scratch_card.html?pid=1755220_23369703&authDuoId=1755220&cpsSign=CL_200826_1755220_23369703_958397402f8d39d5e472d5047f76961f&duoduo_type=2&campaign=ddjb&cid=launch_download_roulette_"}],"resource_list":null},"msg":"success"}
-
code/http_status说明
-
code/http_status |
说明 |
200 |
数据获取成功 |
-1 |
数据获取失败 |
401 |
IP没有添加白名单 |
429 |
访问次数超限 |
403 |
关键参数丢失 |
405 |
请求方式不对 |