京东转链API-新---本接口采用6台16核心64G内存服务器,江苏和北京双机房,负载均衡技术,1G独享带宽,放心调用。
接口地址:http://api.zhetaoke.com:20000/api/open_jing_union_open_promotion_byunionid_get.ashx
支持格式:json
请求方式:get/post,请尽量使用post。
请求示例:http://api.zhetaoke.com:20000/api/open_jing_union_open_promotion_byunionid_get.ashx?appkey=&materialId=&unionId=&positionId=&chainType=2
请求参数说明:
|
名称
|
类型
|
必填
|
说明
|
|
appkey
|
String
|
是
|
折淘客对接秘钥appkey,折淘客通用。
|
|
materialId
|
string
|
是
|
推广物料url,例如活动链接、商品链接等;支持仅传入skuid
重要的事情说三遍:该参数需要进行Urlencode编码!该参数需要进行Urlencode编码!该参数需要进行Urlencode编码!
|
|
unionId
|
string
|
是
|
京东联盟ID,为一串数字。
|
|
positionId
|
string
|
否
|
自定义推广位id
重要的事情说三遍:该参数可以自定义数字!该参数可以自定义数字!该参数可以自定义数字!
自定义的数字,自己在本地跟用户做好关联,订单中会透出自定义的数字。
如果返利需要用到此字段,如果是导购,不需要此字段。
|
|
pid
|
string
|
否
|
联盟子推客身份标识(不能传入接口调用者自己的pid)
|
|
couponUrl
|
string
|
否
|
优惠券领取链接,在使用优惠券、商品二合一功能时入参,且materialId须为商品详情页链接。
该参数值不为空时,优先使用传入的优惠券,否则自动匹配官方优惠券。
重要的事情说三遍:该参数需要进行Urlencode编码!该参数需要进行Urlencode编码!该参数需要进行Urlencode编码!
|
|
subUnionId
|
string
|
否
|
子渠道标识,您可自定义传入字母、数字或下划线,最多支持80个字符,该参数会在订单行查询接口中展示。
|
|
chainType
|
string
|
否
|
转链类型,1:长链, 2 :短链 ,3: 长链+短链,默认短链,短链有效期60天。
|
|
giftCouponKey
|
string
|
否
|
礼金批次号。
|
相关说明:
|
名称
|
类型
|
说明
|
|
使用说明
|
|
支持导购,支持返利
1、如果需要返利,positionId自定义数字,订单中会透出自定义的数字。
1、如果是导购,positionId为空即可。
|
JSON返回示例:
{
"jd_union_open_promotion_byunionid_get_response":{
"result":"{"code":200,"data":{"shortURL":"https://u.jd.com/twnxxOV"},"message":"success","requestId":"o_0b1a819a_kifnakd5_31436913"}",
"code":"0"
}
}
/*shortURL为自己的推广链接*/