唯品会商品详情信息接口
需要授权
1683人使用

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

如果调用接口出现 user has no union auth,requestId:genByGoodsIdWithOauth

下载“唯享客”app登录即可



接口地址: http://api.tbk.dingdanxia.com/vip/item_info 在线测试
请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

signature

string

接口签名,查看创建规则,(可在后台开启或关闭,关闭状态可不需要此参数)

id

String

6918661798452982548

商品ID

返回参数说明

标记

类型

例子

说明

goodsId

String

商品id

goodsName

String

商品名称

goodsDesc

String

商品描述,字段暂不输出

destUrl

String

商品落地页

goodsThumbUrl

String

商品缩略图

goodsCarouselPictures

List<String>

商品轮播图:根据商品id查询时返回

goodsMainPicture

String

商品主图

categoryId

Long

商品三级分类id

categoryName

String

商品三级分类

sourceType

Integer

商品类型:0-自营,1-MP

marketPrice

String

市场价(元)

vipPrice

String

唯品价(元)

commissionRate

String

佣金比例(%)

commission

String

佣金金额(元

discount

String

折扣:唯品价/市场价 保留两位小数字符串

goodsDetailPictures

List<String>

商品详情图片:根据商品id查询商品信息时返回

cat1stId

Long

商品一级分类id

cat1stName

String

商品一级分类名称

cat2ndId

Long

商品二级分类id

cat2ndName

String

商品二级分类名称

brandStoreSn

String

商品品牌sn

brandName

String

商品品牌名称

brandLogoFull

String

商品品牌logo全路径地址

schemeEndTime

Long

商品推广计划有效期预估截止时间:仅为预估时间,仅做参考;时间戳,单位:毫秒

sellTimeFrom

Long

商品售卖开始时间,时间戳,单位毫秒

sellTimeTo

Long

商品售卖结束时间,时间戳, 单位毫秒

weight

Integer

推广权重,用于确定推广该商品的优先级,权重值越大,优先级越高

storeInfo

StoreInfo

店铺信息

L storeId

String

店铺id

L storeName

String

店铺名称

commentsInfo

GoodsCommentsInfo

商品评价信息

L comments

Integer

商品评论数

L goodCommentsShare

String

商品好评率:百分比,不带百分号

storeServiceCapability

StoreServiceCapability

商品所属店铺服务能力评价

L storeScore

String

店铺评分:保留两位小数

L storeRankRate

String

店铺同品类排名比例:例如10表示前10%

brandId

Long

商品所属档期(专场)id

schemeStartTime

Long

商品所属推广方案开始时间:时间戳,单位:毫秒

saleStockStatus

Integer

商品库存状态:1-已抢光,2-有库存,3-有机会,当列表查询库存或者查询商品详情时返回

status

Integer

商品状态:0-下架,1-上架

prepayInfo

PrepayInfo

商品预付信息

L isPrepay

Integer

是否预付商品:0-否,1-是

L prepayPrice

String

预付到手价:元

L firstAmount

String

预付首款金额:元

L lastAmount

String

预付尾款金额:元

L prepayFavAmount

String

预付优惠金额: 元

L deductionPrice

String

抵扣价格(首款+优惠金额):元

L prepayDiscount

String

预付折扣:(唯品价-优惠金额)/唯品价 保留两位小数的数字字符串

L prepayFirstStartTime

Long

首款支付开始时间:时间戳,单位毫秒

L prepayFirstEndTime

Long

首款支付结束时间:时间戳,单位毫秒

L prepayLastStartTime

Long

尾款支付开始时间:时间戳,单位毫秒

L prepayLastEndTime

Long

尾款支付结束时间:时间戳,单位毫秒

joinedActivities

List<ActivityInfo>

商品参与活动信息:未参与活动集合为空

L actType

Integer

活动类型:18-唯品快抢

L actName

String

活动名称

L beginTime

Long

开始时间:时间戳,单位毫秒

L endTime

Long

结束时间:时间戳,单位毫秒

L foreShowBeginTime

Long

预热开始时间:时间戳,单位毫秒

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"data": {
		"marketPrice": "599.00",
		"commissionRate": "11",
		"goodsId": "6918661798452982548",
		"discount": "0.40",
		"goodsCarouselPictures": [
			"https://a.vpimg2.com/upload/merchandise/pdcvop/00100319/10000547/960169153-1971527585845714944-1971527585845714946-1_750x750_75.jpg",
			"https://a.vpimg4.com/upload/merchandise/pdcvop/00100319/10000547/1606932054-1971527585845714944-1971527585845714946-2_750x750_75.jpg",
			"https://a.vpimg3.com/upload/merchandise/pdcvop/00100319/10000547/594601152-1971527585845714944-1971527585845714946-3_750x750_75.jpg",
			"https://a.vpimg2.com/upload/merchandise/pdcvop/00100319/10000547/1139405595-1971527585845714944-1971527585845714946-4_750x750_75.jpg",
			"https://a.vpimg3.com/upload/merchandise/pdcvop/00100319/10000547/48298936-1971527585845714944-1971527585845714946-15_750x750_75.jpg",
			"https://a.vpimg2.com/upload/merchandise/pdcvop/00100319/10000547/349942073-1971527585845714944-1971527585845714946-16_750x750_75.jpg"
		],
		"goodsDetailPictures": [
			"https://a.vpimg3.com/upload/merchandise/pdcvop/00100319/10000547/1671954618-1971527585845714944-1971527585845714946-601.jpg",
			"https://a.vpimg2.com/upload/merchandise/pdcvop/00100319/10000547/2128225592-1971527585845714944-1971527585845714946-602.jpg",
			"https://a.vpimg2.com/upload/merchandise/pdcvop/00100319/10000547/1285640825-1971527585845714944-1971527585845714946-603.jpg",
			"https://a.vpimg3.com/upload/merchandise/pdcvop/00100319/10000547/1166753415-1971527585845714944-1971527585845714946-604.jpg",
			"https://a.vpimg2.com/upload/merchandise/pdcvop/00100319/10000547/693512268-1971527585845714944-1971527585845714946-605.jpg",
			"https://a.vpimg4.com/upload/merchandise/pdcvop/00100319/10000547/2091305022-1971527585845714944-1971527585845714946-606.jpg",
			"https://a.vpimg3.com/upload/merchandise/pdcvop/00100319/10000547/1878538880-1971527585845714944-1971527585845714946-607.jpg",
			"https://a.vpimg4.com/upload/merchandise/pdcvop/00100319/10000547/1684625435-1971527585845714944-1971527585845714946-608.jpg",
			"https://a.vpimg3.com/upload/merchandise/pdcvop/00100319/10000547/1567661769-1971527585845714944-1971527585845714946-609.jpg",
			"https://a.vpimg2.com/upload/merchandise/pdcvop/00100319/10000547/1531121197-1971527585845714944-1971527585845714946-610.jpg",
			"https://a.vpimg4.com/upload/merchandise/pdcvop/00100319/10000547/1715031171-1971527585845714944-1971527585845714946-611.jpg",
			"https://a.vpimg2.com/upload/merchandise/pdcvop/00100319/10000547/523463827-1971527585845714944-1971527585845714946-612.jpg",
			"https://a.vpimg3.com/upload/merchandise/pdcvop/00100319/10000547/992472737-1971527585845714944-1971527585845714946-613.jpg",
			"https://a.vpimg2.com/upload/merchandise/pdcvop/00100319/10000547/1182538693-1971527585845714944-1971527585845714946-614.jpg",
			"https://a.vpimg3.com/upload/merchandise/pdcvop/00100319/10000547/1770034939-1971527585845714944-1971527585845714946-615.jpg",
			"https://a.vpimg3.com/upload/merchandise/pdcvop/00100319/10000547/2051286385-1971527585845714944-1971527585845714946-616.jpg",
			"https://a.vpimg2.com/upload/merchandise/pdcvop/00100319/10000547/2146724188-1971527585845714944-1971527585845714946-617.jpg",
			"https://a.vpimg2.com/upload/merchandise/pdcvop/00100319/10000547/1687698675-1971527585845714944-1971527585845714946-618.jpg",
			"https://a.vpimg2.com/upload/merchandise/pdcvop/00100319/10000547/204491665-1971527585845714944-1971527585845714946-619.jpg",
			"https://a.vpimg3.com/upload/merchandise/pdcvop/00100319/10000547/398789859-1971527585845714944-1971527585845714946-620.jpg",
			"https://a.vpimg2.com/upload/merchandise/ugcaudit/2019/09/03/142/8d584674-ce37-11e9-9e3e-02020ad4977c.jpg"
		],
		"categoryName": "女式牛仔裤~尚未启用",
		"prepayInfo": {
			"isPrepay": 0
		},
		"cat2ndName": "女下装",
		"cat1stName": "女装",
		"vipPrice": "239.00",
		"commission": "26.29",
		"cat1stId": 311,
		"goodsName": "【2020春新款】荧光磨白破洞小脚翻边休闲牛仔裤",
		"storeServiceCapability": {
			"storeScore": "98.00",
			"storeRankRate": "1.00"
		},
		"brandName": "丽丽",
		"brandLogoFull": "http://a.vpimg3.com/upload/brandcool/0/55ff1056f02b4df28f3bad5c1d587cd4/10000547/primary.png",
		"brandStoreSn": "10000547",
		"sellTimeFrom": 1537857153000,
		"schemeStartTime": 1583805600000,
		"commentsInfo": {
			"comments": 5,
			"goodCommentsShare": "100.00"
		},
		"saleStockStatus": 2,
		"schemeEndTime": 1584324000000,
		"sourceType": 0,
		"sellTimeTo": 1735660800000,
		"brandId": 1710613684,
		"goodsThumbUrl": "https://a.vpimg4.com/upload/merchandise/pdcvop/00100319/10000547/960169153-1971527585845714944-1971527585845714946-1_750x750_50.jpg",
		"cat2ndId": 330,
		"storeInfo": {
			"storeName": "唯品自营",
			"storeId": "ST00000"
		},
		"goodsMainPicture": "https://a.vpimg3.com/upload/merchandise/pdcvop/00100319/10000547/960169153-1971527585845714944-1971527585845714946-1.jpg",
		"destUrl": "https://m.vip.com/product-1710613684-6918661798452982548.html",
		"categoryId": 390566,
		"status": 1
	}
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。