一、接口概述
淘寶訂單相關 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:00end_time訂單創建結束時間2025-01-31 23:59:59status訂單狀態（如 已發貨）TRADE_FINISHEDpage_no頁碼1page_size每頁顯示數量20
- 響應示例： json json 代碼解讀復制代碼{ "total_count": 100, "orders": [ { "order_id": "1234567890", "buyer_name": "張三", "total_amount": 200.00, "status": "已發貨" } ] }
2. 訂單詳情接口
- 請求方式：HTTP POST
- 核心參數： 參數名說明示例值tid訂單 ID1234567890
- 響應示例： json json 代碼解讀復制代碼{ "order_id": "1234567890", "buyer_info": { "name": "張三", "phone": "13800138000" }, "product_list": [ { "product_name": "商品A", "quantity": 2, "price": 100.00 } ] }
3. 物流信息接口
- 請求方式：HTTP POST
- 核心參數： 參數名說明示例值tid訂單 ID1234567890logistics_no物流單號SF123456789
- 響應示例： json css 代碼解讀復制代碼{ "company_name": "順豐速運", "logistics_trace": [ { "time": "2025-01-16 08:00:00", "location": "XX市XX區集散中心", "status": "已收件" } ] }
四、代碼示例（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 接口，開發者可高效實現訂單管理、物流追蹤等核心功能，為電商系統提供數據支持。建議定期查閱淘寶開放平臺，及時跟進接口更新。如需進一步優化，可結合數據分析工具（如生意參謀）提升運營效率。
