開放平台 API 需確保:身份驗證 (誰在調用)、授權控制 (能訪問什麼)、傳輸安全 (防竄改/重放)。主流方案三大陣營:
最簡單,基於 HTTP 標準頭。必須配合 HTTPS,否則 Base64 編碼的用戶名密碼等同明文傳輸。
Authorization: Basic base64_encode("username:password")
https://user:pass@api.example.com/resource
<?php
$fp = fsockopen("api.example.com", 443, $errno, $errstr, 30);
if (!$fp) die("$errstr ($errno)");
$auth = base64_encode("user:pass");
$request = "GET /resource HTTP/1.1\r\n";
$request .= "Host: api.example.com\r\n";
$request .= "Authorization: Basic $auth\r\n";
$request .= "Connection: Close\r\n\r\n";
fwrite($fp, $request);
while (!feof($fp)) echo fgets($fp, 1024);
fclose($fp);
?>
| 優點 | 缺點 |
|---|---|
| 極簡實現、廣泛支持、無狀態 | 每次請求傳密碼、無撤銷機制、無範圍控制、僅適合服務端間可信調用 |
解決「第三方應用無需獲取用戶密碼即可訪問用戶資源」的授權框架。核心角色:資源擁有者 (用戶)、客戶端 (第三方應用)、授權服務器、資源服務器 (API)。
基於 XML 的協議,運行於 HTTP/HTTPS 之上。特點:
SoapClient / SoapServer (需啟用 `php_soap` 擴展)。<?php
// 客戶端調用示例
$client = new SoapClient("https://api.example.com/service?wsdl", [
'trace' => 1, // 調試用
'exceptions' => true,
]);
try {
$result = $client->SomeMethod(['param' => 'value']);
var_dump($result);
} catch (SoapFault $e) {
echo "SOAP Fault: {$e->getMessage()}";
// var_dump($client->__getLastRequest()); // 查看請求 XML
}
?>
| 場景 | 推薦方案 | 理由 |
|---|---|---|
| 內部微服務、服務端間調用、極簡需求 | HTTP Basic Auth (強制 HTTPS) 或 API Key (Header/Query) | 零開發成本、無狀態、效能最高 |
| 開放平台、第三方應用接入、用戶授權 | OAuth 2.0 (授權碼模式 + PKCE) | 標準化、安全、支持範圍控制、令牌刷新、撤銷 |
| 企業級集成、銀行/電信/政府、需強契約/安全標準 | SOAP (WS-* 標準) | 工具鏈成熟、合規性強、支持複雜事務與安全策略 |
| 現代 Web/移動 API、RESTful 風格 | OAuth 2.0 / OpenID Connect / JWT (Bearer Token) | 生態豐富、無狀態擴展、前後端分離友好 |