階段 1 · 網站是怎麼組成的
SDK
某個服務提供給開發者使用的工具包、型別、輔助函式與範例。
先用一句話理解
英文全名：Software Development Kit
某個服務提供給開發者使用的工具包、型別、輔助函式與範例。
打個比方
像原廠附的工具箱和說明書，幫你更快接上服務。
什麼時候會遇到
串接付款、AI、登入、Email、雲端服務時。
再往深一點看
SDK（Software Development Kit）是服務方為了讓開發者更方便串接自家 API 所打包的工具集，通常包含函式庫、型別定義、輔助工具和範例程式碼。它和直接呼叫 API 的差別在於：SDK 封裝了認證流程、請求重試、錯誤解析與型別安全，讓你少寫大量樣板程式碼。例如 Stripe SDK 讓你不必自己處理簽章驗證與 HTTP 細節，Clerk SDK 把整個登入頁面和 session 管理都包好了。SDK 本質上是一個 dependency，裝進來就對該服務版本形成依賴，服務方改版時要注意升版紀錄。
舉個例子
你串接 OpenAI 的語言模型：安裝官方 openai SDK 後，只需要幾行程式碼就能呼叫 chat.completions.create()，SDK 幫你處理了 HTTP 請求格式、認證 header、回應解析與串流模式——不用 SDK 的話這些都要自己實作。
常見誤解
- - 只照官方範例貼上，沒有加錯誤處理，一旦 API 呼叫失敗就讓整個流程無聲靜止，使用者完全不知道發生了什麼。
- - 把 SDK 的 API 金鑰直接寫在前端程式碼裡，等於把秘密公開在瀏覽器原始碼，任何人都能拿走。
- - SDK 版本沒鎖定，某天 npm install 裝到新版，原有的 API 行為改了，功能卻無聲壞掉。
相關名詞
相關服務
StripeOpenAI APIClerk