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

一、接口概述

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

订单列表查询：批量获取指定时间范围内的订单信息，支持按状态、时间等条件筛选。
订单详情获取：通过订单 ID 查询买家信息、商品清单、支付状态等详细数据。
物流轨迹追踪：实时获取订单的物流状态及运输节点信息。

二、申请与准备流程

注册与认证
- 访问c0b.cc/R4rbK2 ，获取账号。小编:Taobaoapi2014
- 创建应用：在控制台创建新应用，获取 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 复制代码

{
  "total_count": 100,
  "orders": [
    {
      "order_id": "1234567890",
      "buyer_name": "张三",
      "total_amount": 200.00,
      "status": "已发货"
    }
  ]
}

2. 订单详情接口

请求方式：HTTP POST
核心参数：

参数名说明示例值

tid 订单 ID 1234567890

参数名	说明	示例值
`tid`	订单 ID	`1234567890`

响应示例： json

json 复制代码

{
  "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

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

响应示例：

json

css 复制代码

{
  "company_name": "顺丰速运",
  "logistics_trace": [
    {
      "time": "2025-01-16 08:00:00",
      "location": "XX市XX区集散中心",
      "status": "已收件"
    }
  ]
}

四、代码示例（Python）

python

python 复制代码

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 接口，开发者可高效实现订单管理、物流追踪等核心功能，为电商系统提供数据支持。建议定期查阅淘宝开放平台，及时跟进接口更新。如需进一步优化，可结合数据分析工具（如生意参谋）提升运营效率。