PHP 整合淘寶開放平台 SDK 呼叫商品查詢介面完整範例

本文提供基於官方 PHP SDK 的淘寶開放平台 taobao.user.seller.get 介面呼叫完整範例，涵蓋沙箱/正式環境切換、關鍵參數配置與常見坑點。

前置準備

1. 前往淘寶開放平台下載最新 PHP SDK 壓縮包。
2. 解壓後將 TopSdk.php 與 top/ 目錄置於專案同層路徑。
3. 註冊應用獲取 appkey、appsecret；沙箱測試用官方測試帳號 sandbox_c_1。

核心程式碼實作

<?php
header('Content-Type: text/html; charset=utf-8');
require_once 'TopSdk.php';

// 環境切換：修改 TopClient.php 第 8 行 $gatewayUrl
// 沙箱：https://gw.api.tbsandbox.com/router/rest
// 正式：https://gw.api.taobao.com/router/rest

$c = new TopClient();
$c->appkey = '你的_appkey';       // 必填
$c->secretKey = '你的_appsecret'; // 必填
$sessionKey = '授權後的_session_key'; // 沙箱測試帳號授權獲得

$req = new UserSellerGetRequest();
$req->setFields('nick,user_id,type'); // 指定回傳欄位
// $req->setNick('sandbox_c_1');      // 沙箱指定 nick

try {
    $resp = $c->execute($req, $sessionKey);
    echo 'API 回應：
';
    print_r($resp);
    echo '
';
} catch (Exception $e) {
    echo '呼叫失敗：' . $e->getMessage();
}
?>

環境遷移檢查清單

常見錯誤排查

• Invalid appkey：檢查環境網址與 appkey 是否對應。
• Session expired：沙箱 session 時效短，重新授權獲取。
• Missing required field：setFields() 必須包含介面要求的必填欄位。

遵循此範例可快速完成淘寶 API 串接，專注業務邏輯開發而非底層通訊細節。