淘宝买家/卖家订单列表、订单详情、订单物流 API 接口全攻略

一、接口概述
淘宝订单相关 API 接口为开发者提供了获取订单数据、追踪物流状态的核心能力，支持以下三大功能：

订单列表查询：批量获取指定时间范围内的订单信息，支持按状态、时间等条件筛选。
订单详情获取：通过订单 ID 查询买家信息、商品清单、支付状态等详细数据。
物流轨迹追踪：实时获取订单的物流状态及运输节点信息。
二、申请与准备流程
注册与认证
创建应用：在控制台创建新应用，获取 App Key 和 App Secret（接口调用凭证）。

权限申请

申请目标接口权限：

订单列表：taobao.trades.sold.get（批量查询）或 taobao.trades.sold.search（条件搜索）。
订单详情：taobao.trade.fullinfo.get。
物流信息：taobao.logistics.trade.trackget。
提交资质审核（如企业营业执照），等待平台审批。

三、接口调用详解
1. 订单列表接口
请求方式：HTTP POST

核心参数：

参数名 说明 示例值
start_time 订单创建开始时间 2025-01-01 00:00:00
end_time 订单创建结束时间 2025-01-31 23:59:59
status 订单状态（如 已发货） TRADE_FINISHED
page_no 页码 1
page_size 每页显示数量 20
响应示例： json

json

体验AI代码助手

代码解读

复制代码

{ "total_count": 100, "orders": [ { "order_id": "1234567890", "buyer_name": "张三", "total_amount": 200.00, "status": "已发货" } ] }
2. 订单详情接口
请求方式：HTTP POST

核心参数：

参数名 说明 示例值
tid 订单 ID 1234567890
响应示例： json

json

体验AI代码助手

代码解读

复制代码

{ "order_id": "1234567890", "buyer_info": { "name": "张三", "phone": "13800138000" }, "product_list": [ { "product_name": "商品A", "quantity": 2, "price": 100.00 } ] }
3. 物流信息接口
请求方式：HTTP POST

核心参数：

参数名 说明 示例值
tid 订单 ID 1234567890
logistics_no 物流单号 SF123456789
响应示例：

json

css

体验AI代码助手

代码解读

复制代码

{ "company_name": "顺丰速运", "logistics_trace": [ { "time": "2025-01-16 08:00:00", "location": "XX市XX区集散中心", "status": "已收件" } ] }
四、代码示例（Python）
python

python

体验AI代码助手

代码解读

复制代码

import requests import time import hmac import hashlib import urllib.parse # 封装好的第三方数据商平台接口，复制链接获取测试。 demo url=c0b.cc/R4rbK2  wechat id:Taobaoapi2014 def generate_sign(params, app_secret): sorted_params = sorted(params.items(), key=lambda x: x[0]) query_str = urllib.parse.urlencode(sorted_params) sign = hmac.new(app_secret.encode('utf-8'), query_str.encode('utf-8'), hashlib.md5).hexdigest().upper() return sign def get_order_logistics(app_key, app_secret, tid, logistics_no): url = "https://eco.taobao.com/router/rest" params = { "method": "taobao.logistics.trade.trackget", "app_key": app_key, "timestamp": str(int(time.time())), "v": "2.0", "format": "json", "sign_method": "hmac", "fields": "company_name,logistics_trace", "tid": tid, "logistics_code": logistics_no } params["sign"] = generate_sign(params, app_secret) response = requests.get(url, params=params) return response.json() # 使用示例 app_key = "your_app_key" app_secret = "your_app_secret" tid = "1234567890" logistics_no = "SF123456789" result = get_order_logistics(app_key, app_secret, tid, logistics_no) print(result)

五、注意事项
权限与频率

免费版接口调用频率通常为 500 次 / 分钟，企业版可申请更高配额。
物流接口需额外申请 logistics 类目权限。
数据安全

敏感信息（如买家地址、电话）需加密传输，避免泄露。
严格遵守《淘宝开放平台开发者协议》，禁止爬取非授权数据。
错误处理

捕获错误码（如 10001 权限不足、10006 频率超限），实现重试机制。
物流信息可能存在延迟，建议结合 last_modified 字段判断更新状态。
签名规范

使用淘宝提供的 SDK 生成签名，确保参数排序和编码正确。
六、结语
通过合理使用淘宝订单 API 接口，开发者可高效实现订单管理、物流追踪等核心功能，为电商系统提供数据支持。建议定期查阅淘宝开放平台，及时跟进接口更新。如需进一步优化，可结合数据分析工具（如生意参谋）提升运营效率。

审核编辑 黄宇