拼多多生成营销工具推广链接/绑定备案接口
需要授权
1377人使用

生成营销工具推广链接

绑定备案入参:pid、custom_parameters、channel_type=10,并且打开生成的链接

注意:p_id_list与custom_paramters参数组合只能绑定一个用户,一个用户可以绑定多个p_id_list与custom_paramters参数组合。(为了避免重复绑定,建议p_id_list与custom_paramters参数组合唯一映射)

接口地址: http://api.tbk.dingdanxia.com/pdd/prom_url_generate 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

p_id_list

STRING

推广位,例如:8735184_70977074

custom_parameters

STRING

自定义参数,为链接打上自定义标签;自定义参数最长限制64个字节;

generate_qq_app

BOOLEAN

是否生成qq小程序

generate_schema_url

BOOLEAN

是否返回 schema URL

generate_short_url

BOOLEAN

是否生成短链接。true-是,false-否,默认false

generate_we_app

BOOLEAN

是否生成小程序推广

channel_type

INTEGER

营销工具类型,必填:-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端页面,27-带货赢千万,28-满减券活动B端页面,29-满减券活动C端页面,30-免单B端页面,31-免单C端页面,32-转盘得现金B端页面,33-转盘得现金C端页面

scratch_card_amount

LONG

刮刮卡指定金额(单位分),可指定2-100元间数值,即有效区间为:[200,10000]

diy_one_yuan_param

String

一元购自定义参数,json格式,例如:{"goods_sign":"Y9b2_0uSWMFPGSaVwvfZAlm_y2ADLWZl_JQ7UYaS80K"}

diy_sp_red_packet_param

String

超级红包自定义参数,json格式,例如:{"goods_sign":"Y9b2_0uSWMFPGSaVwvfZAlm_y2ADLWZl_JQ7UYaS80K"}

pdd_auth_id

String

切换授权参数

返回参数说明

标记

类型

例子

说明

resource_list

OBJECT[]

resource_list

desc

STRING

活动描述

url

STRING

活动地址

url_list

OBJECT[]

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

推广多人团链接

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的链接

short_url

STRING

推广短链接

url

STRING

推广链接

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

返回示例
{
    "code":200,
    "msg":"请求成功【success】",
    "data":{
        "url_list":[
            {
                "mobile_url":"https://mobile.yangkeduo.com/duo_coupon_landing.html?__page=auth&pid=8735184_71593398&customParameters=123456&authDuoId=8516041&cpsSign=CC_210716_8735184_71593398_2cc8491f8198464ec47ecff9782f70fe&duoduo_type=2&launch_pdd=1&campaign=ddjb&cid=launch_",
                "url":"https://mobile.yangkeduo.com/duo_coupon_landing.html?__page=auth&pid=8735184_71593398&customParameters=123456&authDuoId=8516041&cpsSign=CC_210716_8735184_71593398_2cc8491f8198464ec47ecff9782f70fe&duoduo_type=2"
            }
        ],
        "request_id":"16264012722392217"
    }
}

			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。