前言
一、铺货核心API说明（企业级极简）
淘宝铺货核心依赖两类API，分别对应「获取货源商品数据」和「自有店铺上架商品」，适配跨店铺货、多平台同步、批量上架等企业场景，全程合规调用，避免爬虫风险。
1. 货源商品获取接口（核心）
- 接口标识：
taobao.item_get_full（完整版，推荐铺货用） - 用途：获取目标货源商品（淘宝/1688）的完整数据（标题、主图、详情、SKU、价格），用于铺货前的数据同步
- 鉴权：AppKey + AppSecret 签名，无需店铺授权（仅获取公开数据）
- 核心请求参数：num_iid（货源商品ID，必传）、fields（指定返回字段，可选）
2. 自有店铺上架接口（核心）
- 接口标识：
taobao.item.add（新品上架）、taobao.item.update（商品更新） - 用途：将获取到的货源数据，批量/单个上架到自有淘宝店铺，完成铺货
- 鉴权：AppKey + AppSecret + session（店铺授权，仅可操作自身店铺）
- 核心请求参数：num_iid（可选，更新用）、title、price、pic_url、cid、sku_list（必传）
二、铺货全流程API JSON返回参考（企业级标准）
以下为铺货核心链路的完整JSON返回示例，字段精简、可直接用于开发解析，适配企业铺货系统。
1. 货源商品获取（taobao.item_get_full）返回示例
{ "item_get_response": { "item": { "num_iid": 680123456789, "title": "2026夏季新款纯棉透气短袖T恤 宽松百搭多色", "price": "89.00", "promotion_price": "59.00", "cid": 50015261, "category_name": "女装>T恤", "pic_url": "https://img.taobao.com/imgextra/i1/xxx.jpg", "image_list": [ "https://img.taobao.com/imgextra/i1/xxx1.jpg", "https://img.taobao.com/imgextra/i1/xxx2.jpg" ], "desc": "<p>面料：100%纯棉</p><p>尺码：M/L/XL</p>", "sku_list": { "sku": [ { "sku_id": 12345678901, "price": "59.00", "quantity": 500, "properties_name": "颜色:白色;尺码:L" }, { "sku_id": 12345678902, "price": "59.00", "quantity": 420, "properties_name": "颜色:黑色;尺码:XL" } ] }, "location": "广东 广州", "modified": "2026-05-19 11:30:22" }, "request_id": "top_req_260519113000123" } }
2. 自有店铺商品上架（taobao.item.add）返回示例
{ "item_add_response": { "num_iid": 680987654321, "item_id": 680987654321, "title": "2026夏季新款纯棉透气短袖T恤 宽松百搭多色", "status": "onsale", "cid": 50015261, "created": "2026-05-19 11:35:40", "msg": "商品上架成功", "request_id": "top_req_260519113500456" } }
3. 商品批量铺货（简化返回，适配多商品）
{ "items_batch_add_response": { "total_count": 10, "success_count": 9, "fail_count": 1, "success_items": [ { "num_iid": 680987654321, "title": "2026夏季新款纯棉透气短袖T恤", "status": "onsale" }, { "num_iid": 680987654322, "title": "休闲百搭牛仔裤", "status": "onsale" } ], "fail_items": [ { "title": "夏季运动鞋", "error_msg": "类目ID错误，无法上架" } ], "request_id": "top_req_260519114000789" } }
三、铺货API核心字段说明（企业必用）
- num_iid：商品唯一ID（货源商品/自有上架商品，铺货关联核心）
- title：商品标题（铺货需适配自身店铺风格，可微调）
- price/promotion_price：原价/促销价（铺货定价核心）
- sku_list：SKU规格+库存（多规格商品铺货必备）
- pic_url/image_list：主图+详情图（铺货展示核心）
- cid：类目ID（必须与自有店铺类目匹配，否则上架失败）
- status：商品状态（onsale=在售，铺货成功标识）
- request_id：全链路追踪，铺货失败排错必备
四、企业级铺货API调用要点（极简）
- 获取货源数据时，过滤异常商品（价格≤0、无主图、SKU为空）；
- 上架前，适配自身店铺类目（cid匹配）、调整标题/价格，避免违规；
- 批量铺货时，控制QPS（≤5），避免限流，失败商品单独重试；
- 做好数据校验，确保上架后商品信息与货源一致，减少售后。
