接口使用场景等说明:生成商城推广链接接口,包括多人团和单人团和普通推广链接。购买此推广链接上的商品均有佣金。
环境 | http 地址 | https 地址 |
---|---|---|
正式环境 | http://api.veapi.cn/pdd/pdd_promcmslink | 暂无 |
参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
vekey | String | 是 | V123M56 | 公共参数,接口秘钥,请在会员中心获取 |
p_id_list | String | 是 | 4079456_34211517 | 推广位列表,支持批量。PID间用逗号隔开 |
channel_type | Integer | 否 | 默认1 | 0, "1.9包邮";1, "今日爆款"; 2, "品牌清仓"; 4,"PC端专属商城(已下线,会生成默认商城)" |
custom_parameters | String | 否 | 自定义参数,必须是与p_id备案关联过(参备案接口),为链接打上自定义标签;参数最长限制64个字节;格式:{"uid":"11","sid":"22"},如果您只传Uid,那么也可以直接用字符串表示,如custom_parameters=11。其中 uid 必选,用户唯一标识,每个用户仅且对应一个标识; sid可选,表示上下文信息标识,例如sessionId等。该json字符串中也可以加入其他自定义的key/value对。 | |
generate_mobile | Boolean | 否 | 是否生成手机跳转链接。true-是,false-否,默认false | |
generate_schema_url | Boolean | 否 | 是否返回 schema URL | |
generate_short_url | Boolean | 否 | 是否生成短链接,true-是,false-否 | |
generate_we_app | Boolean | 否 | 默认true | 是否生成拼多多福利券微信小程序推广信息 |
keyword | String | 否 | 搜索关键词 | |
multi_group | Boolean | 否 | 默认false | 单人团多人团标志。true-多人团,false-单人团 |
GET/POST http://api.veapi.cn/pdd/pdd_promcmslink?vekey=xxx&&p_id_list=4079456_34211517
$api="http://api.veapi.cn/pdd/pdd_promcmslink?vekey=xxx&&p_id_list=4079456_34211517"; $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_promcmslink?vekey=xxx&&p_id_list=4079456_34211517"; // 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_promcmslink?vekey=xxx&&p_id_list=4079456_34211517" # 发送请求 response = requests.get(target_url) # 获取页面内容 if response.status_code == 200: print response.text
参数名称 | 参数类型 | 示例值 | 描述 |
---|---|---|---|
total | Integer | 100 | 总量 |
url_list | Object[] | 链接列表 | |
└─ mobile_short_url | String | 唤醒拼多多app短链 | |
└─ mobile_url | String | 唤醒拼多多app链接 | |
└─ multi_group_mobile_short_url | String | 多人团唤醒拼多多app链接 | |
└─ multi_group_mobile_url | String | 多人团唤醒拼多多app长链接 | |
└─ multi_group_short_url | String | 多人团短链,唤起H5页面 | |
└─ multi_group_url | String | 多人团长链,唤起H5页面 | |
multi_url_list | Object | 双人团链接列表 | |
└─ mobile_short_url | String | 双人团唤醒拼多多app短链接 | |
└─ mobile_url | String | 双人团唤醒拼多多app长链接 | |
└─ schema_url | String | schema链接,用户安装拼多多APP的情况下会唤起APP(需客户端支持schema跳转协议) | |
└─ short_url | String | 双人团短链接 | |
└─ tz_schema_url | String | 使用此推广链接,用户安装多多团长APP的情况下会唤起APP(需客户端支持schema跳转协议) | |
└─ url | String | 双人团长链接,唤起H5页面 | |
short_url | String | h5短链接 | |
sign | String | CM1891_2637_0c0b5 | CPSsign |
single_url_list | Object | 单人团链接列表 | |
└─ mobile_short_url | String | 唤醒拼多多app短链接 | |
└─ mobile_url | String | 唤醒拼多多app长链接 | |
└─ schema_url | String | schema链接,用户安装拼多多APP的情况下会唤起APP(需客户端支持schema跳转协议) | |
└─ short_url | String | 对应出参url的短链接,与url功能一致。 | |
└─ tz_schema_url | String | 使用此推广链接,用户安装多多团长APP的情况下会唤起APP(需客户端支持schema跳转协议) | |
└─ url | String | 普通推广长链接,唤起H5页面 | |
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 | 小程序图片 |
{ "error": "0", "msg": "生成商城推广链接成功", "total": "1", "data": [ { "single_url_list": { "we_app_web_view_url": "https://mobile.yangkeduo.com/duo_today_burst.html?pid=4079456_34211517&authDuoId=2003157&cpsSign=CM_221221_4079456_34211517_e5282f66993fbc495011d85880576aa4&_x_ddjb_act=%7B%22st%22%3A%223%22%7D&duoduo_type=2", "url": "https://mobile.yangkeduo.com/duo_today_burst.html?pid=4079456_34211517&authDuoId=2003157&cpsSign=CM_221221_4079456_34211517_e5282f66993fbc495011d85880576aa4&_x_ddjb_act=%7B%22st%22%3A%223%22%7D&duoduo_type=2" }, "sign": "CM_221221_4079456_34211517_e5282f66993fbc495011d85880576aa4", "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%2Fduo_today_burst.html%3Fpid%3D4079456_34211517%26authDuoId%3D2003157%26cpsSign%3DCM_221221_4079456_34211517_e5282f66993fbc495011d85880576aa4%26_x_ddjb_act%3D%257B%2522st%2522%253A%25223%2522%257D%26duoduo_type%3D2", "source_display_name": "拼多多福利券", "title": "商城", "app_id": "wxa918198f16869201", "desc": "拼多多,多实惠,多乐趣。" }, "we_app_web_view_url": "https://mobile.yangkeduo.com/duo_today_burst.html?pid=4079456_34211517&authDuoId=2003157&cpsSign=CM_221221_4079456_34211517_e5282f66993fbc495011d85880576aa4&_x_ddjb_act=%7B%22st%22%3A%223%22%7D&duoduo_type=2", "url": "https://mobile.yangkeduo.com/duo_today_burst.html?pid=4079456_34211517&authDuoId=2003157&cpsSign=CM_221221_4079456_34211517_e5282f66993fbc495011d85880576aa4&_x_ddjb_act=%7B%22st%22%3A%223%22%7D&duoduo_type=2" } ], "request_id": "cbxIqtS" }