淘宝获取商品规格接口item-sku接口操作详解-CRMEB社区

淘宝获取商品规格接口item-sku接口操作详解

管理

编辑

删除

一、接口核心功能

淘宝item-sku接口用于获取商品SKU（库存量单位）的详细信息，包括属性（如颜色、尺码）、库存、价格、销售状态及图片等。SKU是商品的不同规格组合，帮助商家管理库存和消费者了解商品差异。

二、调用流程与参数

1. 注册与授权

步骤：注册淘宝开放平台账号：访问淘宝开放平台/万邦开放平台，使用淘宝账号登录或注册新账号。创建应用：在开发者中心创建应用，填写应用名称、描述等信息，选择“电商后台”类目。获取API密钥：应用创建成功后，获取App Key和App Secret，这是调用接口的身份凭证。申请API权限：在应用管理页面中，申请taobao.item.sku.get或taobao.skus.quantity.update等SKU相关接口的权限。

2. 请求构造

接口地址： https://gw.api.taobao.com/router/rest
必填参数：参数名类型必填说明methodString是接口名称，如taobao.item.sku.getapp_keyString是应用密钥（App Key）timestampString是请求时间戳，格式YYYY-MM-DD HH:mm:ssformatString是响应格式，默认为jsonvString是API版本，默认为2.0sign_methodString是签名方法，如md5或hmacnum_iidString是商品ID（可通过商品链接获取）sku_idString否SKU ID（不传则返回商品所有SKU）is_promotionInt否是否获取促销价，0为否，1为是
签名生成：将所有请求参数按字母顺序排序，拼接成字符串（如app_keyxxxmethodxxx...）。使用App Secret对拼接后的字符串进行加密（MD5或HMAC-SHA256），生成签名并转为大写。

3. 响应解析

返回JSON结构： json 体验AI代码助手代码解读复制代码json { "taobao_item_sku_get_response": { "result": { "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。

三、示例代码（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())

四、注意事项

频率限制：普通开发者QPS≤10，企业认证可提升至100。每日调用上限50000次，建议购买“独立资源池”权限。
数据更新：商品信息每5分钟更新一次，高频调用建议加缓存（如Redis，过期时间30分钟）。
错误处理：常见错误码： 10001：参数错误。 20002：商品不存在。 30001：权限不足。
合规性：禁止存储用户敏感信息（如买家评论中的手机号）。图片需通过CDN代理引用，避免直接使用淘宝源链接。

五、高级应用场景

库存同步：使用taobao.skus.quantity.update接口实时更新库存，结合虚拟库存方案降低出错率。示例请求： json 体验AI代码助手代码解读复制代码json { "method": "taobao.skus.quantity.update", "num_iid": "572050066584", "skus": { "sku": [ {"sku_id": "3880971359554", "quantity": 150} ] } }
促销价获取：设置is_promotion=1以获取活动价、优惠券信息。
批量查询：通过taobao.items.list.get一次性获取多个商品SKU，提升效率。

六、工具支持

API Explorer：在线调试接口，生成代码示例。
开放平台SDK：支持Java、Python、C#等语言，简化流程。
监控：使用阿里云日志服务监控API调用情况，确保系统稳定运行。

通过以上步骤，您可高效集成淘宝SKU接口，实现商品数据自动化管理。