当前位置：首页 > news >正文

淘宝商品SKU规格信息获取指南及item_skuAPI开放接口详解

news 2026/5/12 0:31:03

一、核心接口与功能

淘宝开放平台提供多维度SKU管理接口，核心接口包括：

taobao.item.sku.get：获取商品SKU详情（属性、价格、库存、图片等）。
taobao.skus.quantity.update：实时更新SKU库存。
taobao.item.get：获取商品基础信息（含SKU列表）。
taobao.sku.price.get：动态查询SKU促销价、会员价。

二、操作流程

1. 前期准备

注册与认证：登录淘宝开放平台，完成企业实名认证（需营业执照、法人身份证）。
创建应用：在开发者中心创建应用，选择“电商后台”类目，获取App Key和App Secret（身份凭证）。
申请权限：在应用管理页面申请taobao.item.sku.get、taobao.skus.quantity.update等权限，审核通过后生效。

2. 请求构造与签名

接口地址：https://gw.api.taobao.com/router/rest
必填参数：
- method：接口名称（如taobao.item.sku.get）。
- app_key：应用Key。
- timestamp：时间戳（格式YYYY-MM-DD HH:mm:ss）。
- format：返回格式（推荐json）。
- v：API版本（固定2.0）。
- sign_method：签名算法（md5或hmac-sha256）。
- num_iid：商品ID（必填）。
- sku_id：SKU ID（可选，获取特定SKU时必填）。
签名生成：
- 将参数按字母排序后拼接为字符串，如app_keyxxxmethodxxx...。
- 使用App Secret对拼接字符串加密（MD5或HMAC-SHA256），生成大写签名。

3. 响应解析

成功响应示例：

json

{ "taobao_item_sku_get_response": { "skus": { "sku": [ { "sku_id": "3880971359554", "properties": "颜色:红色;尺码:M", "price": "135.00", "quantity": 200, "img": "http://img.alicdn.com/xxx.jpg" } ] } } }

关键字段：
- sku_id：SKU唯一标识。
- properties：属性组合（如“颜色:红色;尺码:M”）。
- price：当前价格。
- quantity：库存数量。
- img：SKU图片URL。

4. 代码示例（Python）

python

import requests import hashlib app_key = "YOUR_APP_KEY" app_secret = "YOUR_APP_SECRET" num_iid = "572050066584" sku_id = "3880971359554" params = { "method": "taobao.item.sku.get", "app_key": app_key, "timestamp": "2025-07-17 12:00:00", "format": "json", "v": "2.0", "sign_method": "md5", "num_iid": num_iid, "sku_id": sku_id, "is_promotion": 0 } # 生成签名 sorted_params = sorted(params.items(), key=lambda x: x[0]) query = "".join([f"{k}{v}" for k, v in sorted_params]) sign = hashlib.md5((query + app_secret).encode()).hexdigest().upper() params["sign"] = sign # 发送请求 response = requests.get("https://gw.api.taobao.com/router/rest", params=params) print(response.json())