数据接口API

点击获取APKEY

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

更新时间:2020-09-03 12:39:51

请求链接: http://api.web.ecapi.cn/vip/generalLinkById
请求实例: http://api.web.ecapi.cn/vip/generalLinkById?apkey=登录会员中心查看&goodsIdList=xxxx&key=Vxxxxxxx (注:此实例中的密钥为登录用户的真实密钥,不登录不显示,请妥善保管,切勿泄露!)
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
会员限制: 全部会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
频率说明: 不同会员级别调用频率不同,具体可见会员升级页面介绍。会员升级传送门
使用说明: 根据商品id生成联盟链接
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 ->>立即抢购<<-

使用说明

暂无说明

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点击进入)*必要
goodsIdListStringxxxx商品id列表,多个商品用英文,分隔,单次请求商品id不超过50
chanTagStringxxxx渠道标识
keyStringVxxxxxxx唯品会授权账号调用key,可在会员中心“唯品会授权列表”页获取,为V开头的字符串

返回参数

返回参数类型参数说明扩展说明
dataJson返回数据列表
 ├ listJson链接列表
 ├  ├ sourceString链接生成的数据源如果targetType为GOODSID,该值商品id, 如果targetType为URL,该值为唯品会url, 如果targetType为VIP_SMALL和GENERAL_SAMLL时,该值为空(此类型VOP暂未开放)
 ├  ├ urlStringCPS短链接
 ├  ├ longUrlStringCPS长连接
 ├  ├ ulUrlStringCPS通用连接
 ├  ├ deeplinkUrlStringCPS Deeplink链接
 ├  ├ traFromString小程序CPS参数,如果targetType为VIP_SMALL和GENERAL_SAMLL时,该参数将被赋值
 ├  ├ noEvokeUrlStringCPS短链接:不唤起快应用
 ├  ├ noEvokeLongUrlStringCPS长链接:不唤起快应用
 ├  ├ vipWxUrlString唯品会小程序链接:仅在根据商品id获取时返回
 ├  ├ vipWxCodeString唯品会小程序码:仅在根据商品id获取时返回
 ├  ├ vipQuickAppUrlString唯品会快应用链接

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数据获取失败
401IP没有添加白名单
429访问次数超限
403关键参数丢失
405请求方式不对