全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
获取商品详情
接口地址: http://api.vv-tool.com/tool/erps/ks-open-item
接口介绍: 根据商品 id 获取商家的商品详情,不返回已删除的商品
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 请求次数收费,联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
参数名 | 类型 | 必须 | 示例值 | 详情描述 |
---|---|---|---|---|
shop_id | String | 是 | 13211 | 店铺 id(可在快手小店获取) |
kwaiItemId | Long | 是 | 89878666786 | 商品 ID |
vvtype | int | 否 | 1 | 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2 |
请求示例
{
}
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
result | Integer | 1 | 错误码 |
error_msg | String | success | 错误信息 |
data | ItemGetResponseParam | {} | 商品详情数据 |
itemId | Long | 401936318906 | 商品 id |
relItemId | Long | 401936318906 | 三方商品 id |
categoryId | Long | 1003 | 商品所属类目 id |
categoryName | String | 男装 | 商品所属类目名称 |
parentCategoryId | Long | 1002 | 父级类目 id |
parentCategoryName | String | 服饰 | 父级类目名称 |
rootCategoryId | Long | 1001 | 根类目 id |
rootCategoryName | String | 生活 | 根类目名称 |
title | String | 时尚运动装 | 商品标题 |
details | String | 纯棉材质运动装 | 商品详情 |
imageUrls | String[] | ["http://www.baidu.com/1"] | 商品图片 URL(第一张默认为头图) |
detailImageUrls | String[] | ["http://www.baidu.com/1", "http://www.baidu.com/2"] | 图文详情图片 |
skuInfos | SkuInfoResponseParam[] | [] | sku 信息列表 |
kwaiSkuId | Long | 307744885906 | 快手 skuId |
relSkuId | Long | 307744885906 | 外部商品 Sku id,仅供记录外部商品 sku 和快手商品 sku 对应关系 |
skuStock | Long | 100 | sku 库存数 |
imageUrl | String | https://... | sku 图片 url |
skuSalePrice | Long | 1000 | sku 售卖价,单位分 |
volume | Long | 10 | 已售件数 |
isValid | Integer | 1 | 是否有效。0 无效 1 有效 |
createTime | Long | 1560000000000 | 创建时间 时间戳 (毫秒) |
updateTime | Long | 1560000000000 | 更新时间 时间戳 (毫秒) |
specification | String | 白色-L | 规格 |
appkey | String | 123abc | appkey |
skuNick | String | 12345 | skuNick |
skuProp | SkuPropDTO[] | [] | sku 属性信息 |
skuPropId | Long | 4596904 | sku 规格 id |
propId | Long | 4596903 | 规格属性 id |
propName | String | 颜色 | 规格属性名称 |
propValueId | Long | 4596907 | 规格属性值 Id |
propValueName | String | 黑色 | 规格属性值 |
itemId | Long | 401957455906 | 快手商品 id |
skuId | Long | 307744885906 | 快手 skuId |
imageUrl | String | http://... | sku 图片 |
isValid | Integer | 1 | 有效性, 0 失效 1 有效 |
createTime | Long | 1636469261660 | 创建时间,单位毫秒 |
updateTime | Long | 1636469261660 | 更新时间,单位毫秒 |
propSortNum | Long | 1 | 规格排序字段 |
propValueSortNum | Long | 1 | 规格值排序字段 |
propValueRemarks | String | 备注 | 规格值备注 |
propValueGroupId | Long | 2132131112 | 规格值组 id |
isMainProp | Integer | 0 | 是否是主属性 0 否 1 是 |
propVersion | Integer | 1 | sku 属性版本号 1 新版自定义 2 新版标准 |
kwaiItemId | Long | 307744885911 | 快手商品 id |
serviceRule | ServiceRuleNewDTO | {} | 服务规则 |
refundRule | String | 支持 7 天无理由退货 | 退款规则,请求内容为文案: 1:支持 7 天无理由退货 4:不支持 7 天无理由退货 5:支持 7 天无理由退货(拆封后不支持) 6:支持 7 天无理由退货(激活后不支持) 7:支持 7 天无理由退货(安装后不支持) 8:支持 7 天无理由退货(定制类不支持) 9:支持 7 天无理由退货(使用后不支持) ,由 open.item.category.config 获得 |
theDayOfDeliverGoodsTime | Integer | 10 | 发货间隔时间,单位:天,范围在[4,90] |
promiseDeliveryTime | Integer | 172800 | 非预售商品承诺发货时间,单位:秒,取值 86400,172800,259200,分别代表 24、48、72 小时,取值-1 代表发货时间不承诺 注:ServiceRule.theDayOfDeliverGoodsTime 代表预售商品发货间隔时间,故 theDayOfDeliverGoodsTime 和 promiseDeliveryTime 不能同时设置 |
auditStatus | Integer | 2 | 审核状态 0 待审核 1 审核待修改 2 审核通过 3 审核拒绝 |
auditReason | String | 通过 | 审核原因 |
createdTime | Long | 1544444595373 | 创建时间 (毫秒) |
updateTime | Long | 1544444595373 | 更新时间 (毫秒) |
onOfflineStatus | Integer | 1 | 上下架状态 |
parentCategoryList | GetCategoryResponseParam[] | [] | 父级类目列表 |
categoryId | Long | 1065 | 类目 id |
categoryName | String | 手机/数码/电脑办公 | 类目名称 |
categoryPid | Long | 1034 | 父级类目 id |
itemPropValues | ItemPropValueParam[] | [] | 商品属性列表 |
propId | Long | 123213 | 属性 id(规格数量上限 200,规格值数量上限 500) |
radioPropValue | CategoryPropValueParam | {} | 单选属性 (根据 open.item.category.config 中 propInputType 和 required 判断是否必填) |
propValueId | Long | 4718388 | 属性值 id |
propValue | String | 海贼王 | 属性值 |
checkBoxPropValuesList | CategoryPropValueParam[] | [] | 多选属性 (根据 open.item.category.config 中 propInputType 和 required 判断是否必填) |
propValueId | Long | 4718388 | 属性值 id |
propValue | String | 海贼王 | 属性值 |
textPropValue | String | 测试 | 文本属性值 (根据 open.item.category.config 中 propInputType 和 required 判断是否必填,不允许传空字符串) |
datetimeTimestamp | Long | 1577808000000 | 时间戳属性 (根据 open.item.category.config 中 propInputType 和 required 判断是否必填) |
dateRange | DatetimeRangeParam | {} | 时间范围属性 (根据 open.item.category.config 中 propInputType 和 required 判断是否必填) |
startTimeTimestamp | Long | 1577808000000 | 起始时间(毫秒) |
endTimeTimestamp | Long | 1577809000000 | 结束时间(毫秒) |
sortNum | Long | 12 | 序号,open.item.category.config 返回 |
imagePropValues | List | [] | 图片属性列表 (根据 open.item.category.config 中 propInputType 和 required 判断是否必填) |
propName | String | 男装风格 1 | 属性名称 |
propAlias | String | 男装 | 属性别名 |
inputType | Integer | 1 | 输入类型:1-文本 2-checkbox 3-数字 4-邮箱 5-日期 6-url 地址 7-时间范围 8-单选框 9-图片 |
propType | Integer | 1 | 属性类型:1-sku 属性 2-商品属性 |
unitPropValueId | Long | 1 | 单位属性值 Id,open.item.category.config 返回 |
unitPropValueName | String | 毫升 | 单位属性值名称 |
expressTemplateId | Long | 123456 | 运费模板 ID |
purchaseLimit | Boolean | true | 是否限购,true:支持限购,false:不支持限购 |
limitCount | Long | 100 | 限购数量 |
linkUrl | String | http://test.com/ | 商品链接 |
timeOfSale | Long | 1687128312 | 商品开售时间,单位:分 |
itemRemark | String | 商品备注 | 商品备注 |
duplicationStatus | Integer | 2 | 副本审核状态 0 待审核 1 审核待修改 2 审核通过 3 审核拒绝 |
duplicationReason | String | 通过 | 副本审核原因 |
multipleStock | Boolean | false | ture-货品库存模式;false-商品库存模式 |
withholding_money | Integer | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"data": {
"result": 1,
"error_msg": "success",
"data": {
"itemId": 1,
"relItemId": 1,
"categoryId": 1,
"categoryName": "男装",
"parentCategoryId": 1,
"parentCategoryName": "服饰",
"rootCategoryId": 1,
"rootCategoryName": "生活",
"title": "测试商品",
"details": "测试商品描述",
"imageUrls": [
"http://www.baidu.com/1"
],
"detailImageUrls": [
"http://www.baidu.com/1",
"http://www.baidu.com/2"
],
"skuInfos": [
{
"kwaiSkuId": 232425234,
"relSkuId": 2323423523423,
"skuStock": 100,
"imageUrl": "https://...",
"skuSalePrice": 1000,
"volume": 10,
"isValid": 1,
"createTime": 1560000000000,
"updateTime": 1560000000000,
"specification": "白色-L",
"appkey": "123abc",
"skuNick": "123456",
"skuProp": [
{
"skuPropId": 1,
"propId": 1,
"propName": "颜色",
"propValueId": 1,
"propValueName": "黑色",
"itemId": 123,
"skuId": 123,
"imageUrl": "http://...",
"isValid": 1,
"createTime": 0,
"updateTime": 0,
"propSortNum": 1,
"propValueSortNum": 1,
"propValueRemarks": "备注",
"propValueGroupId": 2132131112,
"isMainProp": 0,
"propVersion": 1
}
],
"kwaiItemId": 111
}
],
"serviceRule": {
"refundRule": "支持7天无理由退货",
"theDayOfDeliverGoodsTime": 10,
"promiseDeliveryTime": 172800
},
"auditStatus": 2,
"auditReason": "通过",
"createdTime": 1544444595373,
"updateTime": 1544444595373,
"onOfflineStatus": 1,
"parentCategoryList": [
{
"categoryId": 1065,
"categoryName": "手机/数码/电脑办公",
"categoryPid": 0
}
],
"itemPropValues": [
{
"propId": 123213,
"radioPropValue": {
"propValueId": 1234213213,
"propValue": "海贼王"
},
"checkBoxPropValuesList": [
{
"propValueId": 1234213213,
"propValue": "海贼王"
}
],
"textPropValue": "测试",
"datetimeTimestamp": 1577808000000,
"dateRange": {
"startTimeTimestamp": 1577808000000,
"endTimeTimestamp": 1577809000000
},
"sortNum": 12,
"imagePropValues": [],
"propName": "男装风格1",
"propAlias": "男装",
"inputType": 1,
"propType": 1,
"unitPropValueId": 1,
"unitPropValueName": "毫升"
}
],
"expressTemplateId": 1,
"purchaseLimit": true,
"limitCount": 100,
"linkUrl": "http://test.com/",
"timeOfSale": 1687128312,
"itemRemark": "商品备注",
"duplicationStatus": 2,
"duplicationReason": "通过",
"multipleStock": false
}
},"withholding_money":4
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |