| 功能 | 舊版 | 新版 | 影響 |
|---|---|---|---|
| 驗證機制 | 基本驗證（標頭中的使用者名稱與密碼） | OAuth 2.0（基於憑證的驗證） | 現有整合方案必須進行更新，以處理憑證的產生與更新。 |
| 強制性請求 ID | 可選或非必要 | RequestId 在每個請求中均為強制性欄位 |
所有客戶端應用程式必須針對每次呼叫產生並包含一個唯一的 Request ID。 |
| HTTP 狀態碼合規性 | 自訂或不一致的狀態碼 | 標準 HTTP 狀態碼（例如 200、400、 401、500) | 客戶端應用程式的錯誤處理邏輯可能需要進行修訂。 |
| 統一的請求/回應結構 | 各端點格式不一 | 所有讀寫 API 均採用標準化的 JSON 結構 | 客戶端系統中的解析邏輯和資料模型可能需要更新。 |
| 增強型錯誤載荷 | 簡略或通用型錯誤訊息 | 包含代碼、訊息及提示的詳細錯誤結構 | 客戶端應更新錯誤處理例程以運用新欄位。 |
| 端點 URL 與參數 | 舊版端點路徑與參數名稱 | 更新的端點路徑與參數命名規範 | 所有端點 URL 及請求載荷均須進行檢視與更新。 |
