全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
根据外部 ID 取商品 SKU
接口地址: http://api.vv-tool.com/tool/erps/skusgetcustom
接口介绍: 跟据卖家设定的 Sku 的外部 id 获取商品,如果一个 outer_id 对应多个 Sku 会返回所有符合条件的 sku
这个 Sku 所属卖家从传入的 session 中获取,需要 session 绑定(注:iid 标签里是 num_iid 的值,可以用作 num_iid 使用)
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
shop_id | String | true | 店铺 ID | |
outer_id | String | true | bb | Sku 的外部商家 ID |
fields | String | true | sku_id,properties | 需返回的字段列表。可选值:Sku 结构体中的所有字段;字段之间用“,”隔开 |
vvtype | int | false | 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2,标准版 3,需要标准版的传 3 |
请求示例
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
skus | Sku [] | Sku 对象,具体字段以 fields 决定 | |
sku_id | Number | 123 | sku 的 id |
iid | String | asdf12323adfaa | sku 所属商品 id(注意:iid 近期即将废弃,请用 num_iid 参数) |
num_iid | Number | 12345 | sku 所属商品数字 id |
properties | String | 1243:1215;5626:5125 | sku 的销售属性组合字符串(颜色,大小,等等,可通过类目 API 获取某类目下的销售属性),格式是 p1:v1;p2:v2 |
quantity | Number | 3 | 属于这个 sku 的商品的数量, |
price | String | 200.07 | 属于这个 sku 的商品的价格 取值范围:0-100000000;精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分。 |
created | String | 2009-11-04 15:24:43 | sku 创建日期 时间格式:yyyy-MM-dd HH:mm:ss |
modified | String | 2009-11-04 15:24:43 | sku 最后修改日期 时间格式:yyyy-MM-dd HH:mm:ss |
status | String | normal | sku 状态。 normal:正常 ;delete:删除,淘宝天猫此字段无效 |
properties_name | String | 20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性 1:属性值 1 | sku 所对应的销售属性的中文名字串,格式如:pid1:vid1:pid_name1:vid_name1;pid2:vid2:pid_name2:vid_name2…… |
outer_id | String | 12345 | 商家设置的外部 id。天猫和集市的卖家,需要登录才能获取到自己的商家编码,不能获取到他人的商家编码。 |
withholding_money | int | 11 | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1460,
"time": 1617273033,
"data": {
"withholding_money": 1,
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |
401 | 身份凭证无效 | 在请求头中添加 access_token |
614 | 系统繁忙,请稍后重试 | 系统繁忙,请稍后重试 |