萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 對接淘寶開放平台 SDK 調用商品查詢接口示例

準備工作

  1. 註冊淘寶開放平台應用,獲取 AppKey、AppSecret。
  2. 下載官方 PHP SDK(TopSDK),解壓至項目目錄。
  3. 沙箱環境測試:使用測試賬號 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)防止超額調用被封禁。
copyright © 萬盛學電腦網 all rights reserved