淘宝联盟API
京东联盟API
拼多多API
开放平台API
美团联盟
电影票/肯德基
考拉海购
优惠加油
文娱直充
饿了么
滴滴
喵有券联盟
淘宝联盟API
京东联盟API
拼多多API
开放平台API
美团联盟
电影票/肯德基
考拉海购
优惠加油
文娱直充
饿了么
滴滴
喵有券联盟
点击获取APKEY

正常 获取指定商品id的商品信息 接口测试

获取指定商品id的商品信息

接口地址: http://api.web.ecapi.cn/vip/getGoodsInfo
接口实例: http://api.web.ecapi.cn/vip/getGoodsInfo?apkey=登录会员中心查看&key=Vxxxxxxx&goodsIdList=12456,789465&chanTag=xx&openId=xxx&realCall=xx
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围: 全部会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 ->>立即抢购<<-

使用说明

请求参数

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

返回参数

返回参数 类型 参数说明 扩展说明
data Json 返回数据列表 数据字段说明参见:http://openapi.weimohe.cn/index/index/openapi/id/191.shtml?ptype=5

Json返回示例

{"code":200,"data":[{"marketPrice":"780.00","commissionRate":"4","goodsId":"6918397901629199512","discount":"0.43","goodsCarouselPictures":["https://a.vpimg4.com/upload/merchandise/pdcvis/2019/08/08/6/d2eb0c94-3026-4eb9-86f0-705a256b14b6_750x750_75.jpg","https://a.vpimg4.com/upload/merchandise/pdcvis/2019/08/08/88/ff4451b3-8475-4a68-9736-408a91bebc49_750x750_75.jpg","https://a.vpimg3.com/upload/merchandise/pdcvis/2019/08/08/176/85ebe14b-f4b9-4b8f-8c84-e55b6f5c9356_750x750_75.jpg","https://a.vpimg2.com/upload/merchandise/pdcvis/2019/08/08/55/468b33cb-7a9a-490c-bc36-b174cda90607_750x750_75.jpg","https://a.vpimg2.com/upload/merchandise/pdcvis/2019/08/08/40/2ea1e1d0-c009-45cf-8dcf-96ee44e25fad_750x750_75.jpg","https://a.vpimg4.com/upload/merchandise/pdcvis/603410/2019/0808/123/223d9926-2e9f-40bb-bb7c-c669cb5ab36b_750x750_75.jpg","https://a.vpimg4.com/upload/merchandise/pdcvis/2019/08/08/63/5062b662-aa7c-4017-8f67-869739255bda_750x750_75.jpg"],"goodsDetailPictures":["https://a.vpimg4.com/upload/merchandise/pdcvis/2019/08/08/104/21eb4ca3-6487-491e-9273-6fa3c2e70411.jpg","https://a.vpimg2.com/upload/merchandise/pdcvis/2019/08/08/71/90008f89-21ee-4647-ae3f-8373fdc8f309.jpg","https://a.vpimg3.com/upload/merchandise/pdcvis/2019/08/08/197/7a39b2b2-e7f5-400e-b2c4-0d9d60a0afc8.jpg","https://a.vpimg3.com/upload/merchandise/pdcvis/2019/08/08/77/86245add-b6e6-4bcb-aa5a-b371b9d801d3.jpg","https://a.vpimg3.com/upload/merchandise/pdcvis/2019/08/08/72/516be3e1-4432-47a7-a688-917f5a7cb6e8.jpg","https://a.vpimg3.com/upload/merchandise/pdcvis/2019/08/08/56/d74bb858-e025-4337-bf7c-4b8bf7d2d637.jpg","https://a.vpimg4.com/upload/merchandise/pdcvis/2019/08/08/179/4435818c-83e1-4a08-814b-a05b202c8789.jpg"],"categoryName":"运动裤~尚未启用","prepayInfo":{"isPrepay":0},"cat2ndName":"运动服","cat1stName":"运动户外","vipPrice":"339.00","commission":"13.56","cat1stId":1056,"goodsName":"斐乐春夏季男装裤子FUSION潮牌时尚男款LOGO梭织长裤","storeServiceCapability":{"storeScore":"98.00","storeRankRate":"1.00"},"brandName":"FILA","brandLogoFull":"http://a.vpimg3.com/upload/brandcool/0/34bae8259ad0437587f033957541f91c/10004114/primary.png","brandStoreSn":"10004114","sellTimeFrom":1537859931000,"schemeStartTime":1584496800000,"commentsInfo":{"comments":61,"goodCommentsShare":"92.00"},"saleStockStatus":2,"schemeEndTime":1584669600000,"sourceType":0,"sellTimeTo":1735660800000,"brandId":1710613848,"goodsThumbUrl":"https://a.vpimg3.com/upload/merchandise/pdcvis/2019/08/08/6/d2eb0c94-3026-4eb9-86f0-705a256b14b6_750x750_50.jpg","cat2ndId":275,"storeInfo":{"storeName":"唯品自营","storeId":"ST00000"},"goodsMainPicture":"https://a.vpimg3.com/upload/merchandise/pdcvis/2019/08/08/6/d2eb0c94-3026-4eb9-86f0-705a256b14b6.jpg","destUrl":"https://m.vip.com/product-1710613848-6918397901629199512.html","categoryId":384349,"status":1}],"msg":"success"}

code/http_status说明

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