变更说明:
传入参数取消unionId参数,改为传入key_id,即京东联盟调用key
传入优惠券链接后,如接口返回:
{"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密钥 (点我获取)(*必要) |
materialId | String | https%3a%2f%2fwqitem.jd.com%2fitem%2fview%3fsku%3d23484023378 | 是 | 京东商品链接或京东短链接,需要使用Urlencode进行编码,建议链接使用微Q前缀,能较好适配微信手Q页面 |
key_id | String | xxxx | 是 | 联盟调用key,会员中心京东授权列表页获取 |
positionId | Number | 新增推广位id (不填的话,为其默认生成一个唯一此接口推广位-名称:微信手Q短链接) | ||
couponUrl | String | 优惠券领取链接,在使用优惠券、商品二合一功能时入参,且materialId须为商品详情页链接,需进行Urlencode编码 | ||
chainType | Number | 3 | 转链类型,1:长链, 2 :短链 ,3: 长链+短链,默认短链 | |
subUnionId | String | 子联盟ID | ||
pid | String | 子帐号身份标识,格式为子站长ID_子站长网站ID_子站长推广位ID | ||
autoSearch | Number | 1 | 是否启用优惠券自动搜索功能,如启用且优惠券链接未传入时,系统会自动查询优惠券 | |
giftCouponKey | String | xxx_coupon_key | 礼金批次号 | |
sceneId | String | 1 | 是 | 1、新增sceneId字段(场景ID),支持入参1,2。 2、materialId字段:单品转链时,sceneId=2时支持入参京东主站商品ID、京东商品链接(包含3.cn单品链接);其他场景仅支持入参联盟商品ID、联盟商品链接。非单品转链不影响。 |
command | String | 1 | 是否生成短口令:1生成,默认不生成 | |
proType | String | 5 | 5:种草版二合一 |
返回参数 | 类型 | 参数说明 | 扩展说明 |
shortURL | String | 生成的推广目标链接,以短链接形式,有效期为半年 | |
jCommand | String | 京口令(匹配到红包活动有效配置才会返回京口令) | |
jShortCommand | 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 | 请求方式不对 |