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

淘宝获取商品SKU详情API接口操作指南

news 2025/8/3 7:18:46

一、前置准备

1. 注册与认证

注册开发者账号：访问淘宝开放平台，使用淘宝账号注册并完成企业实名认证（需提交营业执照、法人身份证等材料）。
创建应用：
- 登录开发者中心，进入控制台 > 应用管理 > 创建应用。
- 填写应用名称（如“商品SKU管理工具”）、描述，选择类型为“电商服务”或“自用型”。
- 提交后获取App Key和App Secret，作为调用API的身份凭证。
申请API权限：
- 在应用管理页面，勾选所需权限：
  - taobao.item.sku.get（获取SKU详情）
  - taobao.skus.quantity.update（更新库存，可选）
- 提交申请并等待审核（1-3个工作日）。

2. 环境配置

开发语言：推荐使用Python、Java等支持HTTP请求的语言。
依赖库：安装requests库（Python）用于发送HTTP请求。

二、API调用流程

1. 接口选择

获取单个SKU详情：使用taobao.item.sku.get接口。
批量获取SKU：
1. 调用taobao.items.onsale.get获取在售商品列表。
2. 遍历商品ID，逐个调用taobao.item.sku.get获取SKU信息。

2. 请求构造

接口地址

正式环境：https://gw.api.taobao.com/router/rest

请求参数

参数名	类型	必填	说明
`method`	String	是	接口名称，如`taobao.item.sku.get`
`app_key`	String	是	淘宝分配的App Key
`timestamp`	String	是	时间戳，格式`YYYY-MM-DD HH:mm:ss`（GMT+8）
`format`	String	是	响应格式，推荐`json`
`v`	String	是	API协议版本，填`2.0`
`sign_method`	String	是	签名算法，填`md5`或`hmac-sha256`
`num_iid`	Number	是	商品ID（如`652874751412`）
`sku_id`	Number	否	SKU ID（获取特定SKU时必填）
`fields`	String	否	指定返回字段，如`sku.price,sku.properties,sku.quantity`（不填则返回全部）

签名生成

将所有参数按字母顺序排序，拼接为字符串（如app_keyxxxmethodxxx...）。

使用App Secret对拼接后的字符串进行加密：

python

import hashlib

def generate_sign(params, app_secret):

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()

return sign

3. 发送请求

示例代码（Python）：

python

import requests

app_key = "YOUR_APP_KEY"

app_secret = "YOUR_APP_SECRET"

num_iid = "652874751412" # 替换为实际商品ID

# 构造请求参数

params = {

"method": "taobao.item.sku.get",

"app_key": app_key,

"timestamp": "2025-07-24 09:30:00",

"format": "json",

"v": "2.0",

"sign_method": "md5",

"num_iid": num_iid,

"fields": "sku.price,sku.properties,sku.quantity"

}

# 生成签名

sign = generate_sign(params, app_secret)

params["sign"] = sign

# 发送请求

response = requests.get("https://gw.api.taobao.com/router/rest", params=params)

print(response.json())

三、响应处理

1. 响应解析

成功响应：
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。