淘宝 API 生态入门：以商品详情接口为例的平台集成指南

import requests
import time
import hashlib
import urllib.parse

# 配置你的应用信息（替换为自己的！）
APP_KEY = "你的App Key"
APP_SECRET = "你的App Secret"
# 接口请求地址
API_URL = "https://eco.taobao.com/router/rest"

def generate_sign(params, app_secret):
    """
    生成接口调用签名
    :param params: 所有请求参数（字典）
    :param app_secret: 应用密钥
    :return: 签名字符串
    """
    # 1. 按参数名ASCII码升序排序
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    # 2. 拼接成"key=value"格式的字符串
    sign_str = app_secret
    for key, value in sorted_params:
        # 过滤空值，且value需转成字符串
        if value is not None and str(value).strip() != "":
            sign_str += f"{key}{value}"
    sign_str += app_secret
    # 3. MD5加密并转大写
    sign = hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()
    return sign

def get_taobao_item_detail(num_iid, fields="title,price,pic_url,item_url,sales"):
    """
    获取淘宝商品详情
    :param num_iid: 商品ID（必填）
    :param fields: 需要返回的字段，多个字段用逗号分隔
    :return: 商品详情字典（失败返回None）
    """
    # 1. 构造公共参数
    params = {
        "method": "taobao.item_get",       # 接口名称
        "app_key": APP_KEY,                # 应用Key
        "format": "json",                  # 返回格式
        "v": "2.0",                        # API版本
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),  # 时间戳
        "sign_method": "md5",              # 签名方式
        "num_iid": num_iid,                # 商品ID
        "fields": fields                   # 需要返回的字段
    }
    
    # 2. 生成签名
    params["sign"] = generate_sign(params, APP_SECRET)
    
    try:
        # 3. 发送GET请求（淘宝API推荐GET）
        response = requests.get(API_URL, params=params, timeout=10)
        # 4. 解析响应数据
        result = response.json()
        
        # 5. 处理返回结果
        if "error_response" in result:
            print(f"接口调用失败：{result['error_response']['msg']}（错误码：{result['error_response']['code']}）")
            return None
        else:
            return result["item_get_response"]["item"]
    except requests.exceptions.Timeout:
        print("请求超时，请检查网络或重试")
        return None
    except Exception as e:
        print(f"调用异常：{str(e)}")
        return None

# 测试调用
if __name__ == "__main__":
    # 替换为你要查询的商品ID（示例为淘宝公开商品ID，可自行替换）
    item_id = "1234567890"
    item_detail = get_taobao_item_detail(item_id)
    
    if item_detail:
        print("===== 商品详情 =====")
        print(f"商品标题：{item_detail.get('title')}")
        print(f"商品价格：{item_detail.get('price')} 元")
        print(f"商品主图：{item_detail.get('pic_url')}")
        print(f"商品链接：{item_detail.get('item_url')}")
        print(f"销量：{item_detail.get('sales')}")
    else:
        print("未获取到商品详情")