淘宝客API
京东API
拼多多API
唯品会API
苏宁API
开放平台API
美团平台
企业微信
点击获取APKEY

正常 获取联盟在推商品列表

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

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

使用说明

暂无说明

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点击进入)*必要
keyStringVxxxxxxx唯品会授权账号调用key,可在会员中心“唯品会授权列表”页获取,为V开头的字符串
pageNumber1页码
pageSizeNumber20分页大小:默认20,最大100
queryReputationStringfalse是否查询商品评价信息:默认不查询,该数据在详情页有返回,没有特殊需求,建议不查询
queryStoreServiceCapabilityStringfalse是否查询店铺服务能力信息:默认不查询,该数据在详情页有返回,没有特殊需求,建议不查询
sourceTypeNumber0请求源类型:0-频道,1-组货
jxCodeString精选组货码:当请求源类型为组货时必传
fieldNameStringCOMMISSION排序字段: COMMISSION-佣金,PRICE-价格,COMM_RATIO-佣金比例,DISCOUNT-折扣
orderNumber1排序顺序:0-正序,1-逆序,默认正序
queryStockStringfalse是否查询库存:默认不查询
queryActivityStringfalse是否查询商品活动信息:默认不查询
queryPrepayStringfalse是否查询商品预付信息:默认不查询
channelTypeString0频道类型:0-超高佣,1-出单爆款,2-每日精选; 当请求类型为频道时必传

返回参数

返回参数类型参数说明扩展说明
dataJson返回数据列表
 ├ totalNumber商品总数
 ├ listJson商品列表
 ├  ├ goodsIdString商品id
 ├  ├ goodsNameString商品名称
 ├  ├ goodsDescString商品描述,字段暂不输出
 ├  ├ destUrlString商品落地页
 ├  ├ goodsThumbUrlString商品缩略图
 ├  ├ goodsCarouselPicturesJson商品轮播图根据商品id查询时返回,商品列表不返回
 ├  ├ goodsMainPictureString商品主图
 ├  ├ categoryIdNumber商品三级分类id
 ├  ├ categoryNameString商品三级分类
 ├  ├ sourceTypeNumber商品类型0-自营,1-MP
 ├  ├ marketPriceString市场价(元)
 ├  ├ vipPriceString唯品价(元)
 ├  ├ commissionRateString佣金比例(%)
 ├  ├ commissionString佣金金额(元)
 ├  ├ discountString折扣唯品价/市场价 保留两位小数字符串
 ├  ├ goodsDetailPicturesJson商品详情图片:根据商品id查询商品信息时返回,商品列表不返回
 ├  ├ cat1stIdNumber商品一级分类id
 ├  ├ cat1stNameString商品一级分类名称
 ├  ├ cat2ndIdNumber商品二级分类id
 ├  ├ cat2ndNameString商品二级分类名称
 ├  ├ brandStoreSnString商品品牌sn
 ├  ├ brandNameString商品品牌名称
 ├  ├ brandLogoFullString商品品牌logo全路径地址
 ├  ├ schemeEndTimeNumber商品推广计划有效期预估截止时间仅为预估时间,仅做参考;时间戳,单位:毫秒
 ├  ├ sellTimeFromNumber商品售卖开始时间,时间戳,单位毫秒
 ├  ├ sellTimeToNumber商品售卖结束时间,时间戳, 单位毫秒
 ├  ├ weightNumber推广权重,用于确定推广该商品的优先级,权重值越大,优先级越高
 ├  ├ storeInfoJson店铺信息
 ├  ├  ├ storeIdString店铺id
 ├  ├  ├ storeNameString店铺名称
 ├  ├ commentsInfoJson商品评价信息
 ├  ├  ├ commentsNumber商品评论数
 ├  ├  ├ goodCommentsShareString商品好评率:百分比,不带百分号
 ├  ├ storeServiceCapabilityJson商品所属店铺服务能力评价
 ├  ├  ├ storeScoreString店铺评分:保留两位小数
 ├  ├  ├ storeRankRateString店铺同品类排名比例:例如10表示前10%
 ├  ├ brandIdNumber商品所属档期(专场)id
 ├  ├ schemeStartTimeNumber商品所属推广方案开始时间:时间戳,单位:毫秒
 ├  ├ saleStockStatusNumber商品库存状态:1-已抢光,2-有库存,3-有机会,当列表查询库存或者查询商品详情时返回
 ├  ├ statusNumber商品状态:0-下架,1-上架
 ├  ├ prepayInfoJson商品预付信息
 ├  ├  ├ isPrepayNumber是否预付商品:0-否,1-是
 ├  ├  ├ prepayPriceString预付到手价:元
 ├  ├  ├ firstAmountString预付首款金额:元
 ├  ├  ├ lastAmountString预付尾款金额:元
 ├  ├  ├ prepayFavAmountString预付优惠金额: 元
 ├  ├  ├ deductionPriceString抵扣价格(首款+优惠金额):元
 ├  ├  ├ prepayDiscountString预付折扣:(唯品价-优惠金额)/唯品价 保留两位小数的数字字符串
 ├  ├  ├ prepayFirstStartTimeNumber首款支付开始时间:时间戳,单位毫秒
 ├  ├  ├ prepayFirstEndTimeNumber首款支付结束时间:时间戳,单位毫秒
 ├  ├  ├ prepayLastStartTimeNumber尾款支付开始时间:时间戳,单位毫秒
 ├  ├  ├ prepayLastEndTimeNumber尾款支付结束时间:时间戳,单位毫秒
 ├  ├ joinedActivitiesJson商品参与活动信息:未参与活动集合为空
 ├  ├  ├ actTypeNumber活动类型:18-唯品快抢
 ├  ├  ├ actNameString活动名称
 ├  ├  ├ beginTimeNumber开始时间:时间戳,单位毫秒
 ├  ├  ├ endTimeNumber结束时间:时间戳,单位毫秒
 ├  ├  ├ foreShowBeginTimeNumber预热开始时间:时间戳,单位毫秒

Json返回示例

{"code":200,"data":{"total":68,"list":[{"marketPrice":"4299.00","commissionRate":"11","goodsId":"6917918421524918858","discount":"0.25","categoryName":"连衣裙~尚未启用","cat2ndName":"连衣裙/连体裤~尚未启用","cat1stName":"女装","vipPrice":"1069.00","commission":"117.59","cat1stId":311,"goodsName":"女装V领无袖中长连衣裙","brandName":"PORTS","brandLogoFull":"http://a.vpimg3.com/upload/brandcool/0/9ceb303392a24414964d8e86506c28b6/10001327/primary.png","brandStoreSn":"10001327","sellTimeFrom":1537944496000,"schemeStartTime":1584410400000,"schemeEndTime":1584583200000,"sourceType":0,"sellTimeTo":1735660800000,"brandId":1710615498,"goodsThumbUrl":"https://a.vpimg4.com/upload/merchandise/pdcvis/2018/05/23/129/518ac6af-8a5e-4932-84f6-33dba6398df1.jpg","cat2ndId":384263,"storeInfo":{"storeName":"唯品自营","storeId":"ST00000"},"destUrl":"https://m.vip.com/product-1710615498-6917918421524918858.html","categoryId":391033,"status":1}]},"msg":"success"}

code/http_status说明

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