API文档中心

热门接口:产品ID找同款全量维权查询万能转链字符串ID转换 (有API需求可联系本站)

多多进宝转链接口

调用权限:核心接口会员卡调用
接口使用场景等说明:

本接口是对多多进宝商品ID生成多种推广链接,比如:唤起微信推广链接、唤起拼多多客户端推广链接、唤起微博客户端推广链接、小程序推广链接等等。

注意:

1、调用前务必先绑定pid与custom_paramters参数组合关系,可用于跟单和绑定用户使用,一个用户可以绑定多个p_id与custom_paramters参数组合,但建议pid和custom_paramters组合和用户关系唯一绑定,避免重复。

2、PID和custom_paramters备案关联,请参考关联接口pdd_generate

调用说明

本接口需要您在会员中心授权(如果多用户可传入sessionkey参数)

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/pdd/pdd_promlink 暂无

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
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请到会员中心授权页查看

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
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 

使用curl函数,curl不是php原生库,需要安装才能使用

$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; //返回值
使用okhttp3/httpclient/jsoup/hutool,以hutool为例:

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);
    }
}
推荐使用 requests,支持访问http,https网页:

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

返回值(JSON)

参数名称 参数类型 示例值 描述
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" }

错误码

如果error不为0时,请点此查看错误码表格

相关文章:

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部