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