
接口名称:taobao.item.get
协议:HTTPS + REST 请求,支持 GET/POST
鉴权:基于 AppKey + AppSecret + MD5 签名 校验,防篡改与非法调用
分页 / 筛选:通过 fields 按需指定返回字段,提升传输与解析效率
num_iid:商品唯一 ID(必填)app_key:应用标识timestamp:毫秒时间戳(防重放)sign:MD5 签名fields:限定返回字段,精简数据体积{
"item_get_response": {
"request_id": "req_20260608_145001",
"item": {
"num_iid": "6801234567890",
"title": "夏季纯棉短袖T恤 男女同款",
"price": "89.00",
"promotion_price": "59.00",
"sales": 15680,
"stock": 862,
"pic_url": "https://img.taobao.com/main.jpg",
"location": "广东 广州",
"nick": "品牌官方店",
"desc": "<p>纯棉面料,透气舒适</p>",
"skus": [
{
"sku_id": "123001",
"properties_name": "颜色:白色;尺码:M",
"price": "59.00",
"quantity": 210
},
{
"sku_id": "123002",
"properties_name": "颜色:黑色;尺码:L",
"price": "59.00",
"quantity": 165
}
]
}
}
}item_get_response:统一响应根容器;request_id 用于日志排查、链路追踪。
num_iid:商品主键,查询、去重唯一标识title:商品标题price:原价,promotion_price:活动促销价sales:累计销量,stock:总库存pic_url:商品主图地址nick:店铺名称,location:发货地desc:HTML 格式商品详情sku_id:规格唯一 IDproperties_name:规格名称组合price:单品售价quantity:当前规格库存// 签名错误
{
"error_response": {
"code": 15,
"msg": "Invalid signature"
}
}
// 调用限流
{
"error_response": {
"code": 429,
"msg": "Too many requests"
}
}
// 商品不存在
{
"error_response": {
"code": 201,
"msg": "Item not exists"
}
}skus 数组;原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。