淘宝联盟API

京东联盟API

数据接口API

点击获取APKEY

正常根据商品id生成联盟链接接口测试

根据商品id生成联盟链接

接口地址： http://api.web.ecapi.cn/vip/generalLinkById

接口实例： http://api.web.ecapi.cn/vip/generalLinkById?apkey=登录会员中心查看&goodsIdList=xxxx&chanTag=xxxx&key=Vxxxxxxx&openId=xxxx&realCall=xx&adCode=xxxx

注意事项：如调用接口时数据返回异常，则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码，然后再试。

请求方式：GET

会员范围：全部会员 (新用户注册立刻送7天V1付费会员【注：赠送会员可使用全部接口，但调用频率与免费会员一致，免费会员调用频率可参考会员等级说明】)

必看注意：为保障接口安全及使用效率，调用本站接口前需先添加IP白名单 (IP地址测试)，若IP不固定且无服务器，可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口，禁止将接口重新打包销售或转卖，一经发现，将做帐号封禁处理。

优惠推荐：高性能云服务器2折起，普惠上云，仅需234元/年 ->>立即抢购<<-。

使用说明: 暂无说明

请求参数

参数	类型	请求参数参考值	是否必须	说明
apkey	String	xxxxxxx	是	用户中心 - 系统设置 - 平台设置中查看APKEY密钥 (点我获取)（*必要）
goodsIdList	String	xxxx	是	商品id列表，多个商品用英文,分隔，单次请求商品id不超过50
chanTag	String	xxxx	是	1、chanTag=pid，即推广位标识 (必传)，用来标记推广中的某个资源位，比如APP的banner、icon等（不能含有特殊字符，仅限字母、数字、下划线，长度最大64） 2、如果没有广告位则传默认广告位标识: default_pid
key	String	Vxxxxxxx	是	唯品会授权账号调用key，可在会员中心“唯品会授权列表”页获取，为V开头的字符串
openId	String	xxxx	是	1、渠道用户在渠道侧的用户唯一标识（必传）（如已接入sdk，该值为渠道用户授权绑定唯品会账号的标识，如没接入sdk，该值为渠道用户在渠道侧的用户唯一标识） 2、不能含有特殊字符，仅限字母、数字、下划线，长度最大32，用于识别用户并给用户返利分佣（非常重要！传错影响给用户返利分佣） 3、如果当前调用与用户无关比如后台job触发拉取商品则传默认标识：default_open_id 4、调转链接口与商品接口时，同一用户openId传参需要一致 5、订单里面会带上转链时所传的openId信息
realCall	String	xx	是	1、是否实时调用（必传），true：由用户实时触发的请求，实时给用户展示联盟返回的商品信息或者实时给用户转链生成推广链接。 false：不是由用户实时触发 2、由渠道后台job触发的请求，比如渠道后台job定期调联盟接口拉取商品到渠道自己的库，请按实际情况传该参数
adCode	String	xxxx	是	1、获取物料接口新增返回adCode，用来标识获取推广物料的来源，请准确保存，并在调用转链接口时传入，防止错用 2、调转链接口的时需要传相应的物料接口返回的adCode（必传）,标识获取推广物料的来源，从物料输出接口获取，如当前待转链的物料不是从联盟物料接口获取，则传默认值adCode(工具商接口传vendoapi，渠道商接口传unionapi，旧版本传oldversion)，该参数用于优化用户推荐效果，请勿乱传。 (注：不要取商详接口getByGoodsIds返回adCode字段，商详接口不返回adCode，要取物料接口(列表接口)返回的adCode值)

返回参数

返回参数	类型	参数说明	扩展说明
data	Json	返回数据列表
├　list	Json	链接列表
├　　├　source	String	链接生成的数据源	如果targetType为GOODSID，该值商品id，如果targetType为URL，该值为唯品会url，如果targetType为VIP_SMALL和GENERAL_SAMLL时，该值为空（此类型VOP暂未开放）
├　　├　url	String	CPS短链接
├　　├　longUrl	String	CPS长连接
├　　├　ulUrl	String	CPS通用连接
├　　├　deeplinkUrl	String	CPS Deeplink链接
├　　├　traFrom	String	小程序CPS参数，如果targetType为VIP_SMALL和GENERAL_SAMLL时，该参数将被赋值
├　　├　noEvokeUrl	String	CPS短链接：不唤起快应用
├　　├　noEvokeLongUrl	String	CPS长链接：不唤起快应用
├　　├　vipWxUrl	String	唯品会小程序链接：仅在根据商品id获取时返回
├　　├　vipWxCode	String	唯品会小程序码：仅在根据商品id获取时返回
├　　├　vipQuickAppUrl	String	唯品会快应用链接

Json返回示例: {"code":200,"data":{"list":[{"noEvokeUrl":"https://t.vip.com/xxxxx?&wq=1","vipQuickAppUrl":"hap://app/com.VIP.VIPQuickAPP/pages/index?target=pages/product/detail&params={"productId":"6918508497745885213","brandId":"1710614909"}&tra_from=adp:C01V4m8togrhjl1o::mig_code::ac022xxxxxreqskm","vipWxUrl":"/pages/productDetail/productDetail?brandId=1710614909&goodsId=6918508497745885213&tra_from=adp:Cxxxxgrhjl1o::mig_code%xxxx7&chl_type=wxk","deeplinkUrl":"vipshop://showGoodsDetail?pid=6918508497745885213&goodType=1&tra_from=tra:C01V4m8togrxxxx9sq71dg01rexcoh&f=dx","longUrl":"https://t.vip.com/redirect.php?url=eyJzY2xxxx","vipWxCode":"http://ms.vpimg1.com/upload/actpics/cps/0/2020/03/19/139/letgcw6b2tru31q.png","source":"6918508497745885213","ulUrl":"https://click.union.vip.com/deeplink/showGoodsDetail?pid=6918508497745885213&goodType=1&tra_from=tra:C01VxxxxWiJp9","url":"https://t.vip.com/lP9xxxxp9","traFrom":"adp:C01V4m8togrhjl1o::mig_code::ac0224l27wskt5nxc9sq71dg01reqskm","noEvokeLongUrl":"https://t.vip.com/redirect.php?url=eyJxx"}]},"msg":"success"}

code/http_status说明

code/http_status	说明
200	数据获取成功
-1	数据获取失败
401	IP没有添加白名单
429	访问次数超限
403	关键参数丢失
405	请求方式不对

【公告】

数据接口API

正常根据商品id生成联盟链接接口测试

使用说明

请求参数

返回参数

Json返回示例

code/http_status说明

电话：0531-6896-1851

数据接口API

正常 根据商品id生成联盟链接 接口测试

使用说明

请求参数

返回参数

Json返回示例

code/http_status说明

电话：0531-6896-1851

正常根据商品id生成联盟链接接口测试