接口使用场景等说明:拼多多进宝客生成营销工具推广链接
环境 | http 地址 | https 地址 |
---|---|---|
正式环境 | http://api.veapi.cn/pdd/pdd_rpprom | 暂无 |
参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
vekey | String | 是 | V123M56 | 公共参数,接口秘钥,请在会员中心获取 |
amount | Long | 否 | 初始金额(单位分),有效金额枚举值:300、500、700、1100和1600,默认300 | |
channel_type | Integer | 否 | 营销工具类型,是:-1-活动列表,0-红包(需申请推广权限),2–新人红包,3-刮刮卡,5-员工内购,12-砸金蛋,14-千万补贴B端页面,15-充值中心B端页面,16-千万补贴C端页面,17-千万补贴投票页面,23-超级红包,24-礼金全场N折活动B端页面,27-带货赢千万,28-满减券活动B端页面,29-满减券活动C端页面,30-免单B端页面,31-免单C端页面,32-转盘得现金B端页面,33-转盘得现金C端页面,34-千万神券C端页面,35-千万神券B端页面; 红包推广权限申请流程:(1)打开多多进宝APP(注意不是拼多多APP)进入首页,(2)点超级红包报名banner条,(3)报名成功,即可推广。参考这里 |
|
p_id_list | String[] | 是 | 推广位列表,长度最大为1,例如:60005_612 或 [60005_612] 。活动页生链要求传入授权备案信息,不支持批量生链。 | |
custom_parameters | String | 否 | 本参数是自定义参数,必须是与p_id备案关联过(参备案接口),为链接打上自定义标签;参数最长限制64个字节;格式:{"uid":"11","sid":"22"},如果您只传Uid,那么也可以直接用字符串表示,如custom_parameters=11。其中 uid 必选,用户唯一标识,每个用户仅且对应一个标识; sid可选,表示上下文信息标识,例如sessionId等。该json字符串中也可以加入其他自定义的key/value对。 | |
diy_one_yuan_param | Object | 否 | 一元购自定义参数,json格式,例如:{"goods_sign":"Y9b2_0uSWMFPGSaVwvfZAlm_y2ADLWZl_JQ7UYaS80K"} | |
└─ goods_sign | String | 否 | 商品goodsSign,支持通过goodsSign查询商品 | |
diy_red_packet_param | Object | 否 | 红包自定义参数,json格式。参数格式示例:diy_red_packet_param={"amount_probability":"[200]","dis_text":"true"} | |
└─ amount_probability | Long[] | 否 | 红包金额列表,200、300、500、1000、2000,单位分。红包金额和红包抵后价设置只能二选一,默认设置了红包金额会忽略红包抵后价设置. | |
└─ dis_text | Boolean | 否 | 设置玩法,false-现金红包, true-现金券 | |
└─ not_show_background | Boolean | 否 | 推广页设置,false-红包开启页, true-红包领取页 | |
└─ opt_id | Integer | 否 | 优先展示类目 | |
└─ range_items | Object[] | 否 | 自定义红包抵后价和商品佣金区间对象数组 | |
└─ range_from | Long | 否 | 区间的开始值 | |
└─ range_id | Integer | 否 | range_id为1表示红包抵后价(单位分),range_id为2表示佣金比例(单位千分之几) | |
└─ range_to | Long | 否 | 区间的结束值 | |
generate_qq_app | Boolean | 否 | 是否生成qq小程序 | |
generate_schema_url | Boolean | 否 | 是否返回 schema URL | |
generate_short_url | Boolean | 否 | 是否生成短链接。true-是,false-否,默认false | |
generate_we_app | Boolean | 否 | 是否生成拼多多福利券微信小程序推广信息 | |
scratch_card_amount | Long | 否 | 刮刮卡指定金额(单位分),可指定2-100元间数值,即有效区间为:[200,10000] |
GET/POST http://api.veapi.cn/pdd/pdd_rpprom?vekey=xxxx&p_id_list=4079456_34211517&custom_parameters=6688&channel_type=23&generate_we_app=1
$api="http://api.veapi.cn/pdd/pdd_rpprom?vekey=xxxx&p_id_list=4079456_34211517&custom_parameters=6688&channel_type=23&generate_we_app=1"; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $api); //curl_setopt($ch, CURLOPT_POST, true); //POST方式时启用 //curl_setopt($ch, CURLOPT_POSTFIELDS, $postData ); //POST方式时传参 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); //如果使用https请启用 curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); //如果使用https请启用 curl_setopt($ch, CURLOPT_RETURNTRANSFER, true ); //返回数据流,不直接输出 curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快 curl_setopt($ch, CURLOPT_TIMEOUT, 6); //允许执行的最长秒数。这里设定6S curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); $result = curl_exec($ch); $info = curl_getinfo($ch); curl_close($ch); echo $result; //返回值
import cn.hutool.http.HttpResponse; import cn.hutool.http.HttpRequest; public class testGetParam { public static void main(String[] args) { // API网址 String url = "http://api.veapi.cn/pdd/pdd_rpprom?vekey=xxxx&p_id_list=4079456_34211517&custom_parameters=6688&channel_type=23&generate_we_app=1"; // JDK 8u111版本后,若目标页面为HTTPS协议,请启用proxy用户密码鉴权 //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", ""); // 发送请求 String result = HttpRequest.get(url) .timeout(10000)//设置超时,毫秒 .execute().body(); System.out.println(result); } }
import requests # 要访问的API网页 target_url = "http://api.veapi.cn/pdd/pdd_rpprom?vekey=xxxx&p_id_list=4079456_34211517&custom_parameters=6688&channel_type=23&generate_we_app=1" # 发送请求 response = requests.get(target_url) # 获取页面内容 if response.status_code == 200: print response.text
参数名称 | 参数类型 | 示例值 | 描述 |
---|---|---|---|
desc | String | 活动描述 | |
url | String | 活动地址 | |
url_list | Object[] | url_list | |
└─ mobile_short_url | String | 推广移动短链接,对应出参mobile_url的短链接,与mobile_url功能一致。 | |
└─ mobile_url | String | 推广移动链接,用户安装拼多多APP的情况下会唤起APP,否则唤起H5页面 | |
└─ multi_group_mobile_short_url | String | 推广多人团移动短链接 | |
└─ multi_group_mobile_url | String | 推广多人团移动链接,用户安装拼多多APP的情况下会唤起APP,否则唤起H5页面 | |
└─ multi_group_short_url | String | 推广多人团短链接 | |
└─ multi_group_url | String | 推广多人团链接,唤起H5页面 | |
qq_app_info | Object | 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 | 用户名 | |
schema_url | String | schema链接,用户安装拼多多APP的情况下会唤起APP(需客户端支持schema跳转协议) | |
short_url | String | 推广短链接,对应出参url的短链接,与url功能一致。 | |
tz_schema_url | String | 使用此推广链接,用户安装多多团长APP的情况下会唤起APP(需客户端支持schema跳转协议) | |
url | String | 推广长链接,唤起H5页面 | |
we_app_info | Object | 拼多多福利券微信小程序信息 | |
└─ 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 |
{ "error": "0", "msg": "成功生成营销工具推广链接", "data": [ { "mobile_url": "https://mobile.yangkeduo.com/muti_coupon_rec.html?isActivity=1&__page=duo_eleven&pid=4079456_34211517&token=F874E07EA89CD3E529B7B7E4029CFC8B&customParameters=6688&authDuoId=2003157&cpsSign=RPB_221222_4079456_34211517_186097624f040da10e0eb1f849bf061a&_x_ddjb_act=%7B%22st%22%3A%22115%22%7D&duoduo_type=2&launch_pdd=1&campaign=ddjb&cid=launch_", "we_app_info": { "we_app_icon_url": "http://xcxcdn.yangkeduo.com/pdd_logo.png", "user_name": "gh_a6611aee87d6", "page_path": "/pages/web/web?specialUrl=1&src=https%3A%2F%2Fmobile.yangkeduo.com%2Fmuti_coupon_rec.html%3FisActivity%3D1%26__page%3Dduo_eleven%26pid%3D4079456_34211517%26token%3DF874E07EA89CD3E529B7B7E4029CFC8B%26customParameters%3D6688%26authDuoId%3D2003157%26cpsSign%3DRPB_221222_4079456_34211517_186097624f040da10e0eb1f849bf061a%26_x_ddjb_act%3D%257B%2522st%2522%253A%2522115%2522%257D%26duoduo_type%3D2", "source_display_name": "拼多多福利券", "title": "双11超级红包b端中转页", "app_id": "wxa918198f16869201", "desc": "拼多多,多实惠,多乐趣。" }, "url": "https://mobile.yangkeduo.com/muti_coupon_rec.html?isActivity=1&__page=duo_eleven&pid=4079456_34211517&token=F874E07EA89CD3E529B7B7E4029CFC8B&customParameters=6688&authDuoId=2003157&cpsSign=RPB_221222_4079456_34211517_186097624f040da10e0eb1f849bf061a&_x_ddjb_act=%7B%22st%22%3A%22115%22%7D&duoduo_type=2" } ], "request_id": "I2cWk1S" }