淘宝商品详情 API 技术简析（简易版 + JSON 参考）

一、接口基础接口名称taobao.item.get协议HTTPS REST 请求支持 GET/POST 鉴权基于AppKey AppSecret MD5 签名校验防篡改与非法调用 分页 / 筛选通过fields按需指定返回字段提升传输与解析效率二、请求核心参数num_iid商品唯一 ID必填app_key应用标识timestamp毫秒时间戳防重放signMD5 签名fields限定返回字段精简数据体积三、完整返回 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原价sales累计销量stock总库存pic_url商品主图地址nick店铺名称location发货地descHTML 格式商品详情SKU 嵌套数组核心存放不同规格颜色 / 尺码数据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 } }六、技术要点小结数据为多层嵌套 JSON解析重点处理skus数组价格、库存均为字符串格式业务使用需转为数值类型接口有 QPS 与每日调用额度限制高频场景建议增加本地缓存签名、参数排序是对接最易出错环节。