接口说明:
本接口支持带文案转链,输出内容同样带有文案,链接为转后的链接,支持多个链接转链
传入优惠券链接后,如接口返回:
{"code":-1,"data":{"code":2001901,"message":"优惠券域名host校验错误","requestId":"21922_0b12a2f1_k334xt8w_56585446"},"msg":"优惠券域名host校验错误"}
或类似提示时,只需要将优惠券链接进行Urlencode编码后再传入即可
申请subUnionId说明:(子联盟ID是可选参数,申请权限之后可以用,没有申请的直接忽略这个参数即可)
京东官方要求申请subUnionId后,2个月内日均订单量需要达到500,达不到将收回子联盟ID权限,因此,在联系我们申请前,请确认能否达到,避免程序开发完成后,被官方收回权限,浪费时间和精力。(此限制为京东联盟官方控制,所有第三方接口平台均受此限制,如发现某些平台限制较低,请慎重选择,以免浪费时间和精力,造成损失。)
参数 | 类型 | 请求参数参考值 | 是否必须 | 说明 |
apkey | String | xxxxxxx | 是 | 用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
content | String | xxx | 是 | 文案及链接均可,可一次传入多个链接 |
positionId | String | xxxx | 新增推广位id (不填的话,为其默认生成一个唯一此接口推广位-名称:微信手Q短链接) | |
couponUrl | String | xxxx | 优惠券领取链接,在使用优惠券、商品二合一功能时入参,且materialId须为商品详情页链接,需进行Urlencode编码 | |
chainType | String | 3 | 转链类型,1:长链, 2 :短链 ,3: 长链+短链,默认短链 | |
subUnionId | String | 11111 | 子联盟ID | |
pid | String | xxxx | 子帐号身份标识,格式为子站长ID_子站长网站ID_子站长推广位ID | |
autoSearch | String | 1 | 是否启用优惠券自动搜索功能,如启用且优惠券链接未传入时,系统会自动查询优惠券 | |
giftCouponKey | String | xxxx | 礼金批次号 | |
key_id | String | xxxx | 是 | 联盟调用key,会员中心京东授权列表页获取 |
返回参数 | 类型 | 参数说明 | 扩展说明 |
data | String | 链接转换后原样输出输入文案 |
{"code":200,"data":{"shortURL":"https://u.jd.com/jsxxxxxeu","clickURL":"https://union-click.jd.com/jdc?e=40000&p=AyIxxxxxZUGVk="},"msg":"success"}
code/http_status | 说明 |
200 | 数据获取成功 |
-1 | 数据获取失败 |
401 | IP没有添加白名单 |
429 | 访问次数超限 |
403 | 关键参数丢失 |
405 | 请求方式不对 |