一、接口核心信息（必看基础）

1. 关键基础参数

2. 典型应用场景（聚焦 B2B 需求）

3. 合规红线（避免账号风险）

二、关键参数与返回字段（抓重点）

1. 必传参数（少传必错）

2. 核心返回字段（实用优先）

三、核心实现（精简代码，直接用）

1. 接口客户端（含签名调用）

import timeimport requestsimport hmacimport hashlibfrom datetime import datetimeclass AlibabaProductClient:def __init__(self, app_key, app_secret, access_token):self.app_key = app_keyself.app_secret = app_secretself.access_token = access_tokenself.api_url = "https://api.1688.com/router/json"# 生成阿里签名（避坑：参数ASCII升序，编码UTF-8）def _generate_sign(self, params):sorted_params = sorted(params.items(), key=lambda x: x[0])sign_str = "&".join([f"{k}{v}" for k, v in sorted_params]) + self.app_secretreturn hmac.new(sign_str.encode("utf-8"),digestmod=hashlib.sha256).hexdigest().upper()# 获取商品详情（支持字段筛选）def get_detail(self, product_id, fields=None):# 1. 构造参数params = {"app_key": self.app_key,"method": "alibaba.product.get","format": "json","sign_method": "hmac-sha256","timestamp": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),"version": "1.0","access_token": self.access_token,"product_id": product_id}if fields:params["fields"] = ",".join(fields) if isinstance(fields, list) else fields# 2. 加签名params["sign"] = self._generate_sign(params)# 3. 发请求try:resp = requests.post(self.api_url, data=params, timeout=20,headers={"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)"})resp.raise_for_status()result = resp.json()# 处理错误if "error_response" in result:err = result["error_response"]raise Exception(f"Err{err['code']}: {err['msg']}")return result["alibaba_product_get_response"]["product"]except Exception as e:print(f"调用失败：{str(e)}")return None

2. 核心数据解析（重点拆价格 /sku）

class AlibabaDataParser:# 解析价格梯度（B2B核心需求）@staticmethoddef parse_price(price_data):if not price_data:return {"price_ranges": []}# 提取批量价格ranges = []for item in price_data.get("price_ranges", []):ranges.append({"quantity": int(item.get("quantity", 0)),"price": float(item.get("price", 0))})return {"price_ranges": sorted(ranges, key=lambda x: x["quantity"])}# 解析SKU（多规格场景必用）@staticmethoddef parse_sku(sku_data):if not sku_data:return {"has_sku": False, "sku_list": []}sku_list = []for sku in sku_data:sku_list.append({"sku_id": sku.get("sku_id", ""),"specs": [{"name": s.get("name", ""),"value": s.get("value", "")} for s in sku.get("specs", [])],"price": float(sku.get("price", 0)),"stock": int(sku.get("stock", 0))})return {"has_sku": True, "sku_list": sku_list}

四、快速使用示例（2 种高频场景）

1. 单个商品详情查询

def single_product_demo():# 替换为自己的凭证APP_KEY = "你的app_key"APP_SECRET = "你的app_secret"ACCESS_TOKEN = "你的access_token"PRODUCT_ID = "624658978912"  # 示例商品ID# 初始化客户端client = AlibabaProductClient(APP_KEY, APP_SECRET, ACCESS_TOKEN)# 只查需要的字段（减少数据量）fields = ["product_id", "title", "price", "sku", "company", "sales"]raw_data = client.get_detail(PRODUCT_ID, fields)if raw_data:# 解析关键数据price_info = AlibabaDataParser.parse_price(raw_data["price"])sku_info = AlibabaDataParser.parse_sku(raw_data["sku"])# 打印结果print(f"商品：{raw_data['title']}")print(f"价格梯度：{price_info['price_ranges']}")print(f"供应商：{raw_data['company']['company_name']}（信用：{raw_data['company']['credit_rating']}）")if __name__ == "__main__":single_product_demo()

2. 批量查询（控制并发避限流）

from concurrent.futures import ThreadPoolExecutordef batch_product_demo(product_ids):APP_KEY = "你的app_key"APP_SECRET = "你的app_secret"ACCESS_TOKEN = "你的access_token"client = AlibabaProductClient(APP_KEY, APP_SECRET, ACCESS_TOKEN)# 并发≤2（避429超限）with ThreadPoolExecutor(max_workers=2) as executor:results = []for pid in product_ids:results.append(executor.submit(client.get_detail, pid))# 处理结果for fut in results:data = fut.result()if data:print(f"成功获取：{data['title']}（月销：{data['sales']['monthly_sales']}）")# 调用batch_product_demo(["624658978912", "623547891256"])

五、优化与避坑（高频问题解决）

1. 常见错误码 + 解决方案

2. 性能优化（3 个实用技巧）

六、互动交流