主题
企业级场景下淘宝标准 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 调用代码（带签名、重试、日志、缓存），可直接进生产环境使用。
