全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

查询商品列表


接口地址: http://api.vv-tool.com/tool/erps/ks-item-list


接口介绍: 分页查询商家的商品列表信息,每页返回数最多为 100,推荐值为 20。点击查看详情


必须用户授权 : 需要用户的授权,才能拿到被授权的数据


请求方式: POST


返回格式: JSON


接口收费: 扣账户余额


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

参数名 类型 必须 示例值 详情描述
shop_id String 13211 店铺 id(可在快手小店获取)
kwaiItemId Long 1111 快手商品 id
relItemId Long 11 外部商品 Id.如 kwaiItemId 未传,但 relItemId 传了,将会按照 appkey+relItemId 查询
itemStatus Integer 1 商品状态。不传 kwaiItemId 和 relItemId 时才会生效 1-正常 目前接口只支持 1-正常(商品状态 1 是指未删除的商品)
itemType Integer 1 商品类型。不传 kwaiItemId 和 relItemId 时才会生效 1-自建商品 2 闪电购商品
pageNumber Integer 1 0 < 数值 < totalPage
pageSize Integer 10 推荐值 20,范围为 10~100,超过 100 或不传默认取 100
vvtype int 1 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2

请求示例

{
  
}

请求代码示例

cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例

响应参数

名称 类型 示例值 描述
result Integer 1 返回码,1 成功
error_msg String success 错误信息
data GetItemListResponseParam {} 商品列表返回 data,注:如果传了 relItemId,返回参数类型为 ShelfItemInfoResponseParam,否则返回 GetItemListResponseParam
totalItemCount Long 123 总数
currentPageItemCount Integer 20 当前页商品数量
currentPageNumber Integer 1 当前页码
totalPage Long 2 总页码数
items ShelfItemInfoResponseParam[] [] 商品列表
kwaiItemId Long 401936319911 快手商品 id
skuList 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
userId Long 2167696911 快手用户 id
relItemId Long 401936319911 外部商品 id,仅供记录外部商品和快手商品对应关系
title String 时尚运动衣 商品名称
details String 纯棉材质运动衣,让你动起来 商品描述
mainImageUrl String https://... 商品主图链接
linkUrl String https://... 商品链接
categoryId Long 1003 所属叶子类目 Id
price Number 12345 商品价格 单位:分;
volume Long 100 销量
categoryName String 服装 所属叶子类目名称
status Integer 1 已废弃 请使用 itemStatus
createTime Long 1560080990000 创建时间(毫秒)
updateTime Long 1560080990000 更新时间(毫秒)
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 1 审核状态 0 待审核 1 审核待修改 2 审核通过 3 审核拒绝
auditReason String 标题与实际产品不符,请修改标题 审核原因
shelfStatus Integer 1 上下架状态 0-下架 1-上架
shelfStatusUpdateReason String 库存充足 上下架原因
imageUrls String[] ["http://www.baidu.com/1", "http://www.baidu.com/2"] 商品图片
fromType Integer 1 小店自建商品来源标识 0-小店自建 1-OpenApi 创建,OpenAPI 创建默认为 1
appkey String 123abc appkey
itemStatus Integer 1 商品状态 0 未知 1 正常 2 主播删除 3 系统删除
expressTemplateId Long 1 运费模版 id
itemType Integer 1 商品类型 1-自建商品 2 闪电购商品
multipleStock Boolean false 是否为多仓商品
duplicationStatus Integer 2 副本审核状态 0 待审核 1 审核待修改 2 审核通过 3 审核拒绝
duplicationReason String 通过 副本审核原因
withholding_money Integer 该接口扣费金额(点券)

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1469,
    "time": 1617270403,
    "data": {
  "result": 1,
  "error_msg": "success",
  "data": {
    "totalItemCount": 234225423,
    "currentPageItemCount": 20,
    "currentPageNumber": 1,
    "totalPage": 2,
    "items": [
      {
        "kwaiItemId": 2323423524,
        "skuList": [
          {
            "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
          }
        ],
        "userId": 12345678,
        "relItemId": 1234567890,
        "title": "运动衣",
        "details": "让你动起来",
        "mainImageUrl": "https://...",
        "linkUrl": "https://...",
        "categoryId": 110000,
        "price": 12345,
        "volume": 100,
        "categoryName": "服装",
        "status": 1,
        "createTime": 1560080990000,
        "updateTime": 1560080990000,
        "serviceRule": {
          "refundRule": "支持7天无理由退货",
          "theDayOfDeliverGoodsTime": 10,
          "promiseDeliveryTime": 172800
        },
        "auditStatus": 1,
        "auditReason": "通过",
        "shelfStatus": 1,
        "shelfStatusUpdateReason": "库存充足",
        "imageUrls": [
          "http://www.baidu.com/1",
          "http://www.baidu.com/2"
        ],
        "fromType": 2,
        "appkey": "123abc",
        "itemStatus": 1,
        "expressTemplateId": 1,
        "itemType": 1,
        "multipleStock": false,
        "duplicationStatus": 0,
        "duplicationReason": "通过"
      }
    ]
  }
},"withholding_money":4
}
  
  
  



响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权