接口使用场景等说明:本接口是对多多进宝商品ID生成多种推广链接,比如:唤起微信推广链接、唤起拼多多客户端推广链接、唤起微博客户端推广链接、小程序推广链接等等。
注意:
1、调用前务必先绑定pid与custom_paramters参数组合关系,可用于跟单和绑定用户使用,一个用户可以绑定多个p_id与custom_paramters参数组合,但建议pid和custom_paramters组合和用户关系唯一绑定,避免重复。
2、PID和custom_paramters备案关联,请参考关联接口pdd_generate
环境 | http 地址 | https 地址 |
---|---|---|
正式环境 | http://api.veapi.cn/pdd/pdd_promlink | 暂无 |
参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
vekey | String | 是 | V123M56 | 公共参数,接口秘钥,请在会员中心获取 |
goods_sign_list | String | 是 | 203569064552 | 商品goodsSign列表,支持批量传参批量生链,如:c9r2omogKFFAc7WBwvbZU1ikIb16_J3CTa8HNN,c9b2q-scbWdGZWOxwfjZRH6h5fQG_J0o3khs0T。也支持链接和数字ID参数,如 goods_sign_list=https://p.pinduoduo.com/cnocJfHu,203569064552 ,如果参数值带有链接,请urlencode |
p_id | String | 是 | 4079456_34211517 | 推广位ID |
custom_parameters | String | 是 | {"uid":"11111","sid":"22222"} | 自定义参数,必须是与p_id备案关联过(参备案接口),为链接打上自定义标签;参数最长限制64个字节;格式:{"uid":"11","sid":"22"},如果您只传Uid,那么也可以直接用字符串表示,如custom_parameters=11。其中 uid 必选,用户唯一标识,每个用户仅且对应一个标识; sid可选,表示上下文信息标识,例如sessionId等。该json字符串中也可以加入其他自定义的key/value对。(如果使用GET请求,请使用URLEncode处理参数) |
detail | Long | 否 | 默认0 | 是否需要商品更详细的信息,可选值1或0 |
cash_gift_id | Long | 否 | 多多礼金ID | |
cash_gift_name | String | 否 | 自定义礼金标题,用于向用户展示渠道专属福利,不超过12个字 | |
force_duo_id | Boolean | 否 | true或1,或false或0 | 是否使用多多客专属推广计划 |
generate_authority_url | Boolean | 否 | true或1 | 是否生成带授权的单品链接。如果未授权,则会走授权流程 |
generate_mall_collect_coupon | Boolean | 否 | true或1 | 是否生成店铺收藏券推广链接 |
generate_qq_app | Boolean | 否 | true或1 | 是否生成qq小程序 |
generate_schema_url | Boolean | 否 | true或1 | 是否返回 schema URL |
generate_short_url | Boolean | 否 | true或1 | 是否生成短链接,true-是,false-否 |
generate_we_app | Boolean | 否 | 是否生成拼多多福利券微信小程序推广信息 | |
material_id | String | 否 | 素材ID,可以通过商品详情接口获取商品素材信息 | |
multi_group | Boolean | 否 | true | 是否生成多人团推广链接,true--生成多人团推广链接 false--生成单人团推广链接(默认false)1、单人团推广链接:用户访问单人团推广链接,可直接购买商品无需拼团。2、多人团推广链接:用户访问双人团推广链接开团,若用户分享给他人参团,则开团者和参团者的佣金均结算给推手 |
search_id | String | 否 | 搜索id,建议填写,提高收益。来自搜索等接口 | |
zs_duo_id | Long | 否 | 招商多多客ID,目前不支持批量方式。 | |
sessionkey | String | 否 | 7002 | 多用户专用。如果您的会员卡是多用户版订单查询接口,若要查不同的帐号,请提供该帐号授权的sessionkey值 |
account_id | String | 否 | 联盟号id | 会员中心有多个授权时,用本参数指定要查询哪一个联盟号id数据,联盟号ID请到会员中心授权页查看 |
GET/POST http://api.veapi.cn/pdd/pdd_promlink?vekey=xxx&goods_sign_list=c9b2q-scbWdGZWOxwfjZRH6h5fQG_J0o3khs0T&p_id=4079456_43779369&generate_weiboapp_webview=1
$api="http://api.veapi.cn/pdd/pdd_promlink?vekey=xxx&goods_sign_list=c9b2q-scbWdGZWOxwfjZRH6h5fQG_J0o3khs0T&p_id=4079456_43779369&generate_weiboapp_webview=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_promlink?vekey=xxx&goods_sign_list=c9b2q-scbWdGZWOxwfjZRH6h5fQG_J0o3khs0T&p_id=4079456_43779369&generate_weiboapp_webview=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_promlink?vekey=xxx&goods_sign_list=c9b2q-scbWdGZWOxwfjZRH6h5fQG_J0o3khs0T&p_id=4079456_43779369&generate_weiboapp_webview=1" # 发送请求 response = requests.get(target_url) # 获取页面内容 if response.status_code == 200: print response.text
参数名称 | 参数类型 | 示例值 | 描述 |
---|---|---|---|
mobile_short_url | String | https://p.pinduoduo.com/fEXnXRKe | 对应出参mobile_url的短链接,与mobile_url功能一致。 |
mobile_url | String | 使用此推广链接,用户安装微信的情况下,默认拉起拼多多福利券微信小程序,否则唤起H5页面 | |
qq_app_info | Object | qq小程序信息 | |
└─ app_id | String | 1108233859 | 拼多多小程序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 | 使用此推广链接,用户安装拼多多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 | 小程序图片 | |
detail字段 | String[] | 当有detail参数时详情字段请参考 |
{ "error": "0", "msg": "推广链接生成成功", "data": [ { "mobile_url": "https://mobile.yangkeduo.com/duo_coupon_landing.html?goods_id=423051062050&pid=4079456_34211517&goods_sign=E9L2wBWAFbZEb5jlwvfbPAgcYQxjJtfM_JnfRXlWl4&customParameters=6688&authDuoId=2003157&cpsSign=CC_221220_4079456_34211517_e46cc3cc4d11a6799c079bbf8f96554c&_x_ddjb_act=%7B%22st%22%3A%221%22%7D&duoduo_type=2&launch_pdd=1&campaign=ddjb&cid=launch_dl_force_", "mobile_short_url": "https://p.pinduoduo.com/fEXnXRKe", "we_app_web_view_url": "https://mobile.yangkeduo.com/duo_coupon_landing.html?goods_id=423051062050&pid=4079456_34211517&goods_sign=E9L2wBWAFbZEb5jlwvfbPAgcYQxjJtfM_JnfRXlWl4&customParameters=6688&authDuoId=2003157&cpsSign=CC_221220_4079456_34211517_e46cc3cc4d11a6799c079bbf8f96554c&_x_ddjb_act=%7B%22st%22%3A%221%22%7D&duoduo_type=2", "url": "https://mobile.yangkeduo.com/duo_coupon_landing.html?goods_id=423051062050&pid=4079456_34211517&goods_sign=E9L2wBWAFbZEb5jlwvfbPAgcYQxjJtfM_JnfRXlWl4&customParameters=6688&authDuoId=2003157&cpsSign=CC_221220_4079456_34211517_e46cc3cc4d11a6799c079bbf8f96554c&_x_ddjb_act=%7B%22st%22%3A%221%22%7D&duoduo_type=2", "short_url": "https://p.pinduoduo.com/oPWnisxj", "we_app_web_view_short_url": "https://p.pinduoduo.com/oPWnisxj" } ], "request_id": "4ywQj4n" }