首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >淘宝商品详情 API 技术简析(简易版 + JSON 参考)

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

原创
作者头像
Anzexi58
发布2026-06-08 15:50:47
发布2026-06-08 15:50:47
40
举报
文章被收录于专栏:API接口开发API接口开发

一、接口基础

接口名称:taobao.item.get

协议:HTTPS + REST 请求,支持 GET/POST

鉴权:基于 AppKey + AppSecret + MD5 签名 校验,防篡改与非法调用

分页 / 筛选:通过 fields 按需指定返回字段,提升传输与解析效率

二、请求核心参数

  • num_iid:商品唯一 ID(必填)
  • app_key:应用标识
  • timestamp:毫秒时间戳(防重放)
  • sign:MD5 签名
  • fields:限定返回字段,精简数据体积

三、完整返回 JSON 示例

代码语言:javascript
复制
{
    "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 结构 & 字段简要说明

  1. 外层节点 item_get_response:统一响应根容器;request_id 用于日志排查、链路追踪。
  2. 商品基础字段
  • num_iid:商品主键,查询、去重唯一标识
  • title:商品标题
  • price:原价,promotion_price:活动促销价
  • sales:累计销量,stock:总库存
  • pic_url:商品主图地址
  • nick:店铺名称,location:发货地
  • desc:HTML 格式商品详情
  1. SKU 嵌套数组(核心) 存放不同规格(颜色 / 尺码)数据:
  • sku_id:规格唯一 ID
  • properties_name:规格名称组合
  • price:单品售价
  • quantity:当前规格库存

五、常见错误返回示例

代码语言:javascript
复制
// 签名错误
{
    "error_response": {
        "code": 15,
        "msg": "Invalid signature"
    }
}

// 调用限流
{
    "error_response": {
        "code": 429,
        "msg": "Too many requests"
    }
}

// 商品不存在
{
    "error_response": {
        "code": 201,
        "msg": "Item not exists"
    }
}

六、技术要点小结

  1. 数据为多层嵌套 JSON,解析重点处理 skus 数组;
  2. 价格、库存均为字符串格式,业务使用需转为数值类型;
  3. 接口有 QPS 与每日调用额度限制,高频场景建议增加本地缓存;
  4. 签名、参数排序是对接最易出错环节。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 一、接口基础
  • 二、请求核心参数
  • 三、完整返回 JSON 示例
  • 四、JSON 结构 & 字段简要说明
  • 五、常见错误返回示例
  • 六、技术要点小结
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档