获取通用推广链接
0人使用

网站/APP来获取的推广链接,功能同宙斯接口的自定义链接转换、 APP领取代码接口通过商品链接、活动链接获取普通推广链接,支持传入subunionid参数,可用于区分媒体自身的用户ID。

如果出现优惠券域名host校验错误,需要把couponUrl进行Urlencode编码后再传入即可


注意:couponUrl进行Urlencode编码后再传入



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

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

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

materialId

String

https://item.jd.com/23484023378.html

推广物料

siteId

String

435676

站点ID是指在联盟后台的推广管理中的网站Id、APPID(1、通用转链接口禁止使用社交媒体id入参;2、订单来源,即投放链接的网址或应用必须与传入的网站ID/AppID备案一致,否则订单会判“无效-来源与备案网址不符”)

positionId

long

6

推广位id

subUnionId

String

618_18_c35***e6a

子联盟ID(需要联系运营开通权限才能拿到数据)

ext1

String

100_618_618

推客生成推广链接时传入的扩展字段(查看订单对应字段信息,需要联系运营开放白名单才能看到)

pid

String

618_618_6018

联盟子站长身份标识,格式:子站长ID_子站长网站ID_子站长推广位ID

couponUrl

String

http://coupon.jd.com/ilink/get/get_coupon.action?XXXXXXX

优惠券领取链接,在使用优惠券、商品二合一功能时入参,且materialId须为商品详情页链接 couponUrl需要Urlencode

giftCouponKey

String

xxx_coupon_key

礼金批次号

返回参数说明

标记

类型

例子

说明

clickURL

String

http://union-click.jd.com/jdc?XXXXXXXXXX

生成的目标推广链接,长期有效

返回示例
{
    "code":200,
    "msg":"请求成功【success】",
    "data":{
        "clickURL":"https://union-click.jd.com/jdc?e=&p=AyIGZRNaHAQbAFYeWCUGFw5QG1sWARQAVCsfSlpMWGVCHlBDUAxLBQBNXURQAURETlcNVQtHRU1HRltKQh5JXxxFD19XEQcbAlUbWBYEFQZCW1die3JUIWg4UnYQfzFvAnJVZH4hcjh2ZU1wHXAtdltpRSJyDmNiSwZceCJMcWZkNlw4d2p2cxxrTxZ1ZH41QyxMV1NwCk09YltpUDJTPGpiZncXTA1%2BSWFOIl47SnVlcCZkGWJdR3AsaC8QdRBVBnsvYQVmWDVLO0xlTWcKYChhdmIALWIvdXVLeAlsBHFlZU81D1lgMmZDPmgwfXR1Yi5PJgtkUFw%2BHl1SR0QLWStbFQYTBFYeWh0GIgdUGloRARIAUxxrJQITNxR1XhIGFAJlGmsVBhQHXR1eEgsWBFUdaxUKFjcPTAlJQCI3ZRhrJTISBGUba0pGT1plGVoUABA%3D"
    }
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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