全部
淘宝
拼多多
抖音
京东
快手
当当
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 未授权店铺 根据返回链接进行扫码授权