準備工作
- 註冊淘寶開放平台應用,獲取
AppKey、AppSecret。
- 下載官方 PHP SDK(TopSDK),解壓至項目目錄。
- 沙箱環境測試:使用測試賬號
sandbox_c_1,網關地址 https://gw.api.tbsandbox.com/router/rest。
核心調用代碼
<?php
header("Content-Type: text/html; charset=utf-8");
require_once 'TopSdk.php'; // SDK 入口文件
// 實例化客戶端
$c = new TopClient();
$c->appkey = '你的AppKey'; // 替換
$c->secretKey = '你的AppSecret'; // 替換
$sessionKey = '授權後的SessionKey'; // 沙箱授權獲取
// 構建請求對象(以 taobao.user.seller.get 為例)
$req = new UserSellerGetRequest();
$req->setFields('nick,user_id,type'); // 指定返回字段
// $req->setNick('sandbox_c_1'); // 指定查詢賬號,不填默認當前授權用戶
// 執行請求
$resp = $c->execute($req, $sessionKey);
// 輸出結果
echo "結果:\n";
print_r($resp);
SDK 關鍵類說明
TopClient:網關通信核心類,封裝簽名、HTTP 請求、錯誤處理。
*Request 類:每個 API 對應一個 Request 類(如 ItemGetRequest、TradeGetRequest),封裝業務參數。
execute($request, $sessionKey):發起調用,返回解析後的響應對象或拋出異常。
常見問題與解決
- 簽名錯誤:檢查系統時間是否同步(NTP),參數排序、編碼是否符合規範(SDK 已封裝)。
- 權限不足:確認應用已獲得對應 API 授權(如
taobao.item.get 需商品權限)。
- 沙箱數據為空:沙箱環境數據為模擬數據,正式環境需切換網關至
https://gw.api.taobao.com/router/rest 並使用真實授權。
- 命名空間衝突:SDK 未使用命名空間,項目若用 PSR-4 需手動
require 或配置 classmap。
現代化改造建議
- 使用 Composer 管理依賴:
composer require topthink/think-sdk(社區維護版)。
- 封裝為 Service 類,注入容器,統一異常處理、重試、日誌記錄。
- 引入限流器(如 Token Bucket)防止超額調用被封禁。