一、接口概述

淘宝开放平台的 buyer_order_detail API用于获取买家订单的详细信息，支持单订单查询。该接口需通过严格的授权和签名验证，适用于订单的管理、数据分析和营销策略制定等场景。

二、核心参数说明

三、调用流程

1. 前期准备

• 注册开发者账号：在淘宝开放平台完成企业/个人认证。
• 创建应用：填写应用名称、描述，选择权限（需勾选“获取订单数据”）。
• 获取密钥：生成 AppKey和 AppSecret，用于接口调用。

2. 授权与签名

• 获取access_token：通过OAuth2.0流程获取用户授权令牌。
• 生成签名：按规则拼接参数并生成MD5签名：

  pythondef generate_sign(params, secret):param_str = ''.join([f"{k}{v}" for k, v in sorted(params.items())])sign_str = secret + param_str + secretreturn hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()

3. 请求示例（Python）

pythonimport requestsimport hashlibimport timeimport jsonAPP_KEY = 'your_app_key'APP_SECRET = 'your_app_secret'ACCESS_TOKEN = 'your_access_token'API_URL = 'https://eco.taobao.com/router/rest'def get_order_details(order_id):timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())params = {"app_key": APP_KEY,"method": "taobao.buyer.order.detail.get","session": ACCESS_TOKEN,"timestamp": timestamp,"v": "2.0","sign_method": "md5","order_id": order_id}params["sign"] = generate_sign(params, APP_SECRET)response = requests.get(API_URL, params=params)return response.json() if response.status_code == 200 else None# 测试调用order_id = "1234567890"order_details = get_order_details(order_id)print(json.dumps(order_details, indent=4, ensure_ascii=False))

四、返回数据结构

json{"trade": {"tid": "1234567890",        // 订单ID"status": "TRADE_CLOSED",   // 订单状态"payment": 99.99,           // 支付金额"created": "2025-10-22 10:00:00", // 创建时间"modified": "2025-10-23 12:00:00" // 修改时间},"orders": [{"oid": "654321",          // 商品ID"title": "商品名称","price": 49.99,           // 商品单价"num": 2,                 // 商品数量"total_fee": 99.98        // 商品总价}],"buyer": {"nick": "用户昵称","buyer_rate": true          // 是否已评价}}

五、批量查询方案

• 单接口限制： buyer_order_detail单次仅支持查询一个订单。
• 批量处理建议：
  • 循环调用：通过程序批量调用接口，传入不同 order_id。
  • 分页接口：使用 taobao.trades.sold.get或 taobao.topats.trades.sold.get获取订单列表后，再逐单查询详情。
  • 异步接口： taobao.topats.trades.fullinfo.get支持批量获取最多100笔订单详情。

六、注意事项

1. 频率限制：严格遵守淘宝API调用频率限制，避免被封禁。
2. 安全规范：
   • 妥善保管 AppSecret，防止泄露。
   • 使用HTTPS协议传输数据。
3. 错误处理：
   • 常见错误码： 4003（参数错误）、 4005（授权失败）、 4008（并发超限）。
   • 需捕获异常并记录日志。
4. 数据时效性：订单数据可能存在延迟，需结合业务场景合理使用。