正常唯品会链接生成联盟链接接口在线测试

根据唯品会链接生成联盟链接

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

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

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

请求方式：GET

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

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

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

使用说明: 暂无说明

请求参数

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

返回参数

返回参数	类型	参数说明	扩展说明
data	Json	返回数据列表	参数字段说明参考：http://www.ecapi.cn/index/index/openapi/id/197.shtml?ptype=5

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	请求方式不对