Python 实战：3 步快速接入淘宝开放平台 API 接口-开发者社区

淘宝开放平台（Taobao Open Platform，简称 TOP）提供了丰富的电商相关 API 接口，涵盖商品、订单、用户、物流等核心业务场景。本文将通过3 个核心步骤，教你用 Python 快速实现淘宝开放平台 API 的接入与调用，全程基于官方规范，兼顾实用性与合规性。

前提条件

已注册淘宝开放平台账号，并完成企业 / 个人开发者认证；
已创建应用，获取到AppKey和AppSecret（应用管理页面可查看）；
了解目标接口的权限范围（部分接口需申请开通权限）；
本地安装 Python 3.6+ 环境。

第一步：准备工作 —— 获取关键参数与环境配置

1.1 提取应用核心信息

在淘宝开放平台的「应用管理」-「应用详情」中，复制以下关键参数：

app_key：应用唯一标识；
app_secret：应用密钥（需妥善保管，切勿泄露）；
access_token：若调用需要用户授权的接口，需通过 OAuth2.0 获取（公共接口可忽略）。

1.2 安装必要依赖

淘宝 API 调用需处理HTTP 请求和签名加密，我们使用requests发送请求，hmac/hashlib处理签名，执行以下命令安装：

bash

运行

pip install requests

第二步：核心实现 —— 编写淘宝 API 签名与调用逻辑

淘宝开放平台采用TOP 签名机制（HMAC-SHA1）验证请求合法性，核心规则是：将请求参数按 ASCII 码排序后拼接，结合app_secret进行加密，最终生成签名参数sign。

2.1 编写签名函数

python

运行

import requests import time import hmac import hashlib from urllib.parse import urlencode, quote_plus def taobao_sign(params, app_secret): """ 生成淘宝API签名 :param params: 请求参数字典 :param app_secret: 应用秘钥 :return: 签名结果 """ # 1. 按参数名ASCII码升序排序 sorted_params = sorted(params.items(), key=lambda x: x[0]) # 2. 拼接参数为"key=value"格式 query_string = '&'.join([f"{k}={quote_plus(str(v), safe='')}" for k, v in sorted_params]) # 3. 拼接app_secret前后缀 sign_string = app_secret + query_string + app_secret # 4. HMAC-SHA1加密并转大写 sign = hmac.new(sign_string.encode('utf-8'), digestmod=hashlib.sha1).digest() # 5. Base64编码并转大写 sign_base64 = sign.hex().upper() # 注：部分版本需用base64.b64encode，需根据接口调试调整 return sign_base64

2.2 编写 API 调用主函数

以调用 ** 商品详情查询接口（taobao.item.get）** 为例（沙箱环境可测试，正式环境需权限）：

python

运行

def call_taobao_api(app_key, app_secret, method, params=None): """ 调用淘宝开放平台API :param app_key: 应用Key :param app_secret: 应用秘钥 :param method: 接口方法名（如taobao.item.get） :param params: 接口业务参数 :return: 接口响应结果 """ # 公共请求参数（必填） public_params = { 'app_key': app_key, 'method': method, 'format': 'json', # 返回格式：json/xml 'v': '2.0', # API版本 'timestamp': time.strftime('%Y-%m-%d %H:%M:%S', time.localtime()), 'sign_method': 'hmac-sha1' # 签名方式 } # 合并公共参数与业务参数 all_params = {**public_params, **(params or {})} # 生成签名 all_params['sign'] = taobao_sign(all_params, app_secret) # 发送请求（正式环境：https://eco.taobao.com/router/rest；沙箱环境：https://gw.api.tbsandbox.com/router/rest） url = 'https://eco.taobao.com/router/rest' response = requests.post(url, data=all_params) if response.status_code == 200: return response.json() else: raise Exception(f"请求失败：{response.status_code} - {response.text}")

第三步：实战调用 —— 测试接口并处理响应

3.1 配置参数并调用接口

将你的app_key和app_secret填入，指定目标接口和业务参数，以查询商品详情为例：

python

运行

if __name__ == '__main__': # 替换为你的应用信息 APP_KEY = '你的AppKey' APP_SECRET = '你的AppSecret' # 接口方法名（以商品详情接口为例） API_METHOD = 'taobao.item.get' # 业务参数（根据接口文档填写，如商品ID） business_params = { 'num_iid': '1234567890', # 商品ID，需替换为真实值 'fields': 'title,price,pic_url' # 需要返回的字段 } # 调用接口 try: result = call_taobao_api(APP_KEY, APP_SECRET, API_METHOD, business_params) print("接口响应结果：") print(result) except Exception as e: print(f"调用失败：{e}")

3.2 响应结果处理

接口返回的 JSON 数据包含error_response（失败）或xxx_response（成功，xxx 为接口名），示例成功响应：

json

{ "item_get_response": { "item": { "title": "淘宝商品标题", "price": "99.00", "pic_url": "https://img.alicdn.com/imgextra/xxx.jpg" }, "request_id": "123456789" } }

若出现签名错误（invalid-signature），需检查：