前言
一、铺货核心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），避免限流，失败商品单独重试；
做好数据校验，确保上架后商品信息与货源一致，减少售后。
