淘宝商品详情 API 技术简析（简易版 + JSON 参考）
前言
一、接口基础
接口名称：
协议：HTTPS + REST 请求，支持 GET/POST鉴权：基于 AppKey + AppSecret + MD5 签名 校验，防篡改与非法调用分页 / 筛选：通过
taobao.item.get协议：HTTPS + REST 请求，支持 GET/POST鉴权：基于 AppKey + AppSecret + MD5 签名 校验，防篡改与非法调用分页 / 筛选：通过
fields 按需指定返回字段，提升传输与解析效率二、请求核心参数
num_iid：商品唯一 ID（必填）app_key：应用标识timestamp：毫秒时间戳（防重放）sign：MD5 签名fields：限定返回字段，精简数据体积
三、完整返回 JSON 示例
json
{
"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
}
]
}
}}四、JSON 结构 & 字段简要说明
- 外层节点
item_get_response：统一响应根容器；request_id用于日志排查、链路追踪。 - 商品基础字段
num_iid：商品主键，查询、去重唯一标识title：商品标题price：原价，promotion_price：活动促销价sales：累计销量，stock：总库存pic_url：商品主图地址nick：店铺名称，location：发货地desc：HTML 格式商品详情
SKU 嵌套数组（核心）
存放不同规格（颜色 / 尺码）数据：
sku_id：规格唯一 IDproperties_name：规格名称组合price：单品售价quantity：当前规格库存
五、常见错误返回示例
json
// 签名错误{
"error_response": {
"code": 15,
"msg": "Invalid signature"
}}// 调用限流{
"error_response": {
"code": 429,
"msg": "Too many requests"
}}// 商品不存在{
"error_response": {
"code": 201,
"msg": "Item not exists"
}}六、技术要点小结
数据为多层嵌套 JSON，解析重点处理
skus数组；价格、库存均为字符串格式，业务使用需转为数值类型；
接口有 QPS 与每日调用额度限制，高频场景建议增加本地缓存；
签名、参数排序是对接最易出错环节。
