当前位置：首页 > news >正文

Python 获取淘宝买家订单详情（buyer_order_detail）接口的详细指南

news 2025/8/14 7:56:47

在电商运营中，订单详情数据是商家进行数据分析、客户服务和营销策略制定的重要依据。淘宝提供了 buyer_order_detail 接口，允许开发者获取买家的订单详情数据。本文将详细介绍如何使用 Python 调用该接口获取订单详情，并解析返回的数据。

一、准备工作

（一）注册淘宝开放平台账号

访问淘宝开放平台官网：淘宝开放平台。
注册开发者账号：完成企业或个人开发者注册，填写相关信息。
创建应用：登录开放平台后，创建一个新的应用，填写应用的基本信息，如应用名称、描述等。
获取密钥：完成应用创建后，系统会生成 App Key 和 App Secret，这两个密钥是调用 API 接口的必要凭证。

（二）安装 Python 库

确保 Python 环境中已安装以下库：

requests：用于发送 HTTP 请求。
json：用于解析 JSON 数据。

可以通过以下命令安装：

bash

pip install requests

二、调用接口获取订单详情

（一）构建请求参数

淘宝的 buyer_order_detail 接口需要以下参数：

app_key：应用的 App Key。
method：接口名称，固定为 taobao.buyer.order.detail.get。
session：用户的授权令牌（access_token）。
timestamp：请求的时间戳，格式为 YYYY-MM-DD HH:MM:SS。
v：API 版本号，固定为 2.0。
sign_method：签名方法，固定为 md5。
sign：签名，用于验证请求的合法性。
order_id：订单 ID。

以下是 Python 示例代码，展示如何调用该接口并获取订单详情：

Python

import requests
import hashlib
import time
import json# 配置信息
APP_KEY = 'your_app_key'
APP_SECRET = 'your_app_secret'
ACCESS_TOKEN = 'your_access_token'
API_URL = 'https://eco.taobao.com/router/rest'# 生成签名
def 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()# 获取订单详情
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  # 订单ID}params["sign"] = generate_sign(params, APP_SECRET)response = requests.get(API_URL, params=params)if response.status_code == 200:return response.json()else:print(f"请求失败，状态码：{response.status_code}")return None# 测试代码
if __name__ == "__main__":order_id = "1234567890"  # 示例订单IDorder_details = get_order_details(order_id)if order_details:print(json.dumps(order_details, indent=4, ensure_ascii=False))else:print("未获取到订单信息")

（二）解析返回数据

接口返回的数据通常为 JSON 格式，包含订单的详细信息。以下是返回数据的常见字段：

trade：订单基本信息，包含订单状态、支付信息、物流信息等。
- tid：订单 ID。
- status：订单状态。
- payment：支付金额。
- created：订单创建时间。
- modified：订单修改时间。
orders：订单中的商品信息，包含商品名称、价格、数量等。
- oid：商品 ID。
- title：商品标题。
- price：商品价格。
- num：商品数量。
buyer：买家信息，包含买家昵称、联系方式等。
- nick：买家昵称。
- buyer_rate：买家评价。