要獲取淘寶店鋪的訂單信息,您需要通過淘寶開放平臺(Taobao Open Platform, TOP)提供的API接口來實現。以下是詳細步驟:
1. 注冊淘寶開放平臺賬號
- 訪問淘寶開放平臺
- 注冊開發者賬號并完成實名認證
- 創建應用獲取App Key和App Secret
2. 申請API權限
- 在"我的應用"中找到您的應用
- 進入"API管理"頁面
- 申請以下必要權限:
taobao.trades.sold.get
?(獲取賣家已賣出的交易數據)taobao.trade.fullinfo.get
?(獲取單筆交易的詳細信息)- 其他可能需要的訂單相關API
3. 獲取Access Token
淘寶API使用OAuth2.0認證,需要獲取access_token:
- 引導用戶授權(如果是獲取自己店鋪數據,可以使用店鋪授權)
- 通過授權碼換取access_token
4. 調用API示例
使用SDK調用(推薦)
淘寶提供多種語言的SDK,以下是PHP示例:
php
<?php |
require_once 'TopSdk.php'; |
$c = new TopClient; |
$c->appkey = '您的AppKey'; |
$c->secretKey = '您的AppSecret'; |
$c->format = 'json'; |
$req = new TradesSoldGetRequest; |
$req->setFields("tid,type,status,payment,orders,rx_audit_status"); |
$req->setStartCreated("2023-01-01 00:00:00"); |
$req->setEndCreated("2023-12-31 23:59:59"); |
$req->setPageSize(20); |
$req->setPageNo(1); |
$resp = $c->execute($req, '您的access_token'); |
print_r($resp); |
?> |
直接HTTP調用
POST https://eco.taobao.com/router/rest |
參數: |
method=taobao.trades.sold.get |
app_key=您的AppKey |
timestamp=當前時間戳 |
format=json |
v=2.0 |
sign_method=md5 |
sign=簽名 |
session=您的access_token |
fields=tid,type,status,payment |
start_created=2023-01-01 00:00:00 |
end_created=2023-12-31 23:59:59 |
5. 常用訂單API
taobao.trades.sold.get
?- 獲取賣家已賣出的交易數據taobao.trade.fullinfo.get
?- 獲取單筆交易的詳細信息taobao.trades.sold.increment.get
?- 獲取增量交易數據taobao.logistics.orders.get
?- 查詢物流訂單信息
6. 注意事項
- API調用有頻率限制,需注意不要超過限額
- 敏感信息如買家信息可能被脫敏處理
- 訂單數據量大的情況下建議使用增量接口
- 淘寶API可能會更新,需關注官方文檔變化
- 生產環境需處理異常情況和重試機制
7. 官方文檔參考
- 淘寶開放平臺文檔中心
- 交易API目錄
如需獲取其他店鋪的訂單信息(非自己店鋪),需要該店鋪明確授權,且需符合淘寶平臺規則。