实战解析：1688详情api商品sku、主图数据
1688 商品详情 API 的 SKU 与主图数据，是大多数选品、铺货、比价系统首先要啃下的两块“硬骨头”。下面用一条完整的实战链路，把“拿到商品 ID → 拉出 SKU → 拖走主图”过程中最容易踩的坑、最实用的代码、以及返参里那些看似人畜无害却暗藏杀机的字段一次性讲透。
一、接口选型：item_get 还是 sku_get？
- 已经拿到商品 ID 列表，只想批量刷新价格/库存
再单独调alibaba.item.sku.get可省流量，但官方 QPS 卡得死（默认 1），高并发场景建议先在本地建“SKU 池”，再定时用 item_get 做增量更新。
二、SKU 数据到底长什么样？
以 2025-12 官方文档示例为例，一个 SKU 节点核心字段只有 4 个，但坑都在“单位”和“空值”里：
JSON
{
"sku_id": "987654321012",
"sku_spec": "白色-L",
"sku_price": "19.90", // 字符串，需自己转 float
"sku_stock": 5000 // 单位是“件”，不是“箱”！}实战注意
- 价格字段
sku_price返回的是“单件批发价”，再乘以min_order_quantity才是真正的起批金额。 - 库存
sku_stock只是“展示库存”，真实可售库存要看available_stock（同一节点下若有该字段）。 - 部分类目（包装制品、化工）会把“箱/桶”作为销售单位，spec 里会出现 “1箱=1 200件” 的映射，需要自己做正则拆分。
- 当商品开启“阶梯价”时，SKU 里不会给出 2 件、10 件的批发价，需要再调用
alibaba.cpsMedia.productInfo或爬取 H5 页面解析priceRange字段 。
三、主图、SKU 图、详情图 3 张皮
item_get 一次会给 3 组图片，很多人直接
for img in item_imgs 就完事，结果上线后发现 30 天后全变 403——官方图片链接带 token，有效期 30 天，长期用必须落盘。Python
# 伪代码：一键落盘 3 类图def dump_images(item):
folders = ['主图', 'SKU图', '详情图']
img_lists = [
[item['pic_url']], # 主图只有 1 张
[sku['sku_img'] for sku in item['sku_list']],
re.findall(r'<img src="([^"]+)', item['desc']) # 详情图藏在 HTML
]
for folder, urls in zip(folders, img_lists):
download_to(folder, urls)小技巧
- 主图
pic_url默认 800×800，把域名img.1688.com替换成img.alicdn.com/imgextra/i4再拼_800x800.jpg可拿更高分辨率。 - SKU 图有时为空，前端会 fallback 到主图，自己落地时记得判空，否则同一张图存 N 份。
- 详情图
desc_img字段 2025 年下半年已下线，必须解析desc里的 HTML，正则别忘了匹配//img这种无协议头地址。
四、完整实战：从商品 ID → 落库 SKU+主图
下面这段代码可直接跑通（基于第三方网关，已封装 sign），演示“拿数据 → 解析 SKU → 批量下图片”最简链路：
Python
import requests, os, re, jsonfrom hashlib import md5
APP_KEY = '你的 AppKey'APP_SECRET = '你的 AppSecret'NUM_IID = '610947572360' # 替换你想抓的商品BASE_URL = 'https://api-gw.onebound.cn/1688/item_get/'# 1. 拼参 + 签名params = {
'key': APP_KEY,
'secret': APP_SECRET,
'num_iid': NUM_IID,
'cache': 'yes',
'result_type': 'json',
'lang': 'cn'}sign_str = APP_SECRET + ''.join([f'{k}{v}' for k, v in sorted(params.items())]) + APP_SECRET
params['sign'] = md5(sign_str.encode()).hexdigest().upper()# 2. 调接口res = requests.get(BASE_URL, params=params)data = res.json()['item_get_response']['item']# 3. 解析 SKUskus = [
{
'sku_id': s['sku_id'],
'spec': s['sku_spec'],
'price': float(s['sku_price']),
'stock': int(s.get('sku_stock', 0))
}
for s in data.get('sku_list', [])]# 4. 抓图def save_img(url, path):
if not url: return
url = url if url.startswith('http') else 'https:' + url
os.makedirs(os.path.dirname(path), exist_ok=True)
with open(path, 'wb') as f:
f.write(requests.get(url).content)save_img(data['pic_url'], f'./{NUM_IID}/主图.jpg')for s in data.get('sku_list', []):
save_img(s.get('sku_img'), f'./{NUM_IID}/SKU/{s["sku_id"]}.jpg')# 5. 详情图detail_imgs = re.findall(r'src="([^"]+)"', data.get('desc', ''))for idx, url in enumerate(detail_imgs):
save_img(url, f'./{NUM_IID}/详情/{idx}.jpg')print('SKU 列表：', json.dumps(skus, ensure_ascii=False))五、高频踩坑清单
六、小结
- SKU 数据一定要做“单位/空值/阶梯价”三重校验，否则前端一上架就会出“下单提示价格已过期”的尴尬。
- 主图、SKU 图、详情图链接 30 天失效，落盘+回源策略是生产级必备。
把上面这段代码和清单吃透，基本就能在 1 小时内搭起“SKU+主图”的自动化流水线，后续无论是做选品库、ERP 还是铺货 SaaS，都可直接复用。祝各位调试顺利，永不 403！
如遇任何疑问或有进一步的需求，请随时与我私信或者评论联系。
