获取淘宝店铺订单详情数据的详细指南

API快乐传递者

于 2025-04-24 17:41:19 发布

阅读量557

点赞数 22

分类专栏：淘宝API 文章标签：数据库 python

本文链接：https://blog.csdn.net/2401_87966921/article/details/147485271

版权

淘宝API 专栏收录该内容

45 篇文章

订阅专栏

在电商运营中，订单详情数据是商家进行数据分析、客户服务和营销策略制定的重要依据。淘宝开放平台提供了多个与订单相关的API接口，其中 taobao.trade.fullinfo.get 接口可以用来获取订单的详细信息。本文将详细介绍如何使用 Python 调用该接口获取淘宝店铺订单详情数据。

一、准备工作

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

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

（二）安装 Python 库

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

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

可以通过以下命令安装：

bash

复制

pip install requests

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

（一）构建请求参数

淘宝的 taobao.trade.fullinfo.get 接口需要以下参数：

app_key：应用的 App Key。
method：接口名称，固定为 taobao.trade.fullinfo.get。
session：用户的授权令牌（access_token）。
timestamp：请求的时间戳，格式为 YYYY-MM-DD HH:MM:SS。
v：API 版本号，固定为 2.0。
sign_method：签名方法，固定为 md5。
sign：签名，用于验证请求的合法性。
tid：订单 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 + secret
    return 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.trade.fullinfo.get",
        "session": ACCESS_TOKEN,
        "timestamp": timestamp,
        "v": "2.0",
        "sign_method": "md5",
        "tid": 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"  # 示例订单ID
    order_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：买家评价。