主题
企业级场景下淘宝标准 API 调用规范、接口示例与真实返回结构，适用于 ERP、商品同步、店铺管理、数据分析等系统。
一、适用场景（企业级）
店铺商品上下架管理
商品批量同步、全量拉取
订单、库存、物流对接
多店铺统一管控
数据中台接入、BI 报表
二、企业级调用规范
协议：
HTTPS接口体系：淘宝 TOP API
鉴权：
AppKey + AppSecret + session（店铺授权）签名：
MD5，参数按 ASCII 排序格式：
format=json分页：
page_no / page_size容错：超时重试、熔断、限流控制、日志全链路
三、企业级常用接口示例（3 个核心）
1）获取店铺在售商品列表（taobao.items.onsale.get）
用途：企业 ERP 拉取全店商品、做库存 / 商品同步
请求参数（企业标准）
json
{
"method": "taobao.items.onsale.get", "app_key": "your_appkey", "session": "your_shop_token", "timestamp": "2026-05-15 15:30:00", "format": "json", "v": "2.0", "sign_method": "md5", "page_no": 1, "page_size": 40}
企业级 JSON 返回参考
json
{
"taobao_items_onsale_get_response": {
"total_results": 326,
"items": {
"item": [
{
"num_iid": 680123456789,
"title": "2026夏季商务休闲西装外套",
"price": "299.00",
"nick": "品牌官方旗舰店",
"cid": 50011127,
"pic_url": "https://img.taobao.com/imgextra/i1/xxx.jpg",
"status": "onsale",
"created": "2026-03-12 09:22:11",
"modified": "2026-05-14 16:10:22",
"num": 580,
"sales": 2166
}
]
},
"request_id": "2405151530002999"
}}2）获取商品详情（taobao.item.get）
用途：商品详情同步、SKU、详情页、规格入库
JSON 返回参考
json
{
"item_get_response": {
"item": {
"num_iid": 680123456789,
"title": "2026夏季商务休闲西装外套",
"price": "299.00",
"promotion_price": "269.00",
"num": 580,
"sales": 2166,
"location": "广东 广州",
"cid": 50011127,
"seller_id": 123456789,
"nick": "品牌官方旗舰店",
"pic_url": "https://img.taobao.com/imgextra/i1/xxx.jpg",
"desc": "<p>面料舒适...</p>",
"sku_list": {
"sku": [
{
"sku_id": 12345678901,
"price": "269.00",
"quantity": 120,
"properties_name": "颜色:黑色;尺码:L"
}
]
}
},
"request_id": "2405151532003112"
}}3）获取商品评论列表（taobao.item.review.get）
用途：舆情监控、好评率统计、差评预警
JSON 返回参考
json
{
"item_review_get_response": {
"total_results": 896,
"reviews": {
"review": [
{
"review_id": 2300123456789,
"content": "面料很舒服，版型正，发货快",
"score": 5,
"user_nick": "tb_user_123",
"created": "2026-05-10 11:22:33",
"has_pic": true
}
]
},
"request_id": "2405151535002987"
}}四、企业级关键字段说明（必用）
num_iid：商品唯一 IDtitle：商品标题price / promotion_price：原价 / 活动价num：库存sales：销量cid：类目 IDsku：多规格数据status：商品状态（onsale/instock）request_id：全链路日志定位modified：更新时间（增量同步用）
五、企业级稳定性要点
session 管理：店铺授权 token 过期自动刷新
限流控制：QPS 限制内调用，避免 429
重试机制：超时 / 5xx 指数退避重试
数据校验：价格 > 0、库存≥0、num_iid 合法
缓存策略：Redis 缓存热点商品 1～5 分钟
全链路日志：记录 request_id、耗时、错误码
幂等设计：避免重复同步 / 重复下单
如果你需要，我可以直接给你一段企业级 Python 调用代码（带签名、重试、日志、缓存），可直接进生产环境使用。
