API (Application Programming Interface) 定義為應用程式與作業系統/服務/函式庫交換資訊、呼叫功能的標準化介面規範集合。它不是具體產品，而是技術戰略——制定規範讓不同廠商、不同語言、不同平台的程式碼能在契約層面互操作、複用、組合。

核心價值：通用程式設計環境

• 抽象隔離：呼叫者無需知悉實作細節，僅依賴介面契約 (函式原型、參數、回傳值、錯誤碼、副作用)。
• 可移植性：相同 API 規範下，應用程式可在不同廠商硬體/作業系統上重新編譯/直譯運行 (如 POSIX API、OpenGL、Vulkan)。
• 生態建設：平台提供豐富 API 吸引開發者建立應用生態，應用豐富反推平台價值 (Windows API、Win32、Cocoa、Android SDK、Kubernetes API)。

網路環境下的 API 相容性必要性

異構網路中，應用程式可能遷移、複製、分散部署於不同機器。若各機器 API 不相容，程式將無法跨機器運行、無法遠程呼叫服務、無法構建微服務架構。網路 API 標準化 (如 REST/gRPC/GraphQL、OpenAPI/Swagger 規範) 是分散式系統互操作的前提。

Windows API (Win32 API) 核心三大模組

Windows 核心功能由三大核心 DLL 提供，構成 Win32 API 基石：

模組	檔案名	核心職責	關鍵功能範例
使用者介面子系統	USER32.DLL	視窗管理、訊息迴路、輸入處理、選單/對話框/控制項	CreateWindow, GetMessage, SendMessage, SetWindowLong, DialogBox
圖形裝置介面 (GDI)	GDI32.DLL	2D 繪圖、字型管理、筆刷/畫筆/區域、列印輸出、元檔案	CreatePen, TextOut, BitBlt, StretchBlt, CreateFontIndirect
核心服務	KERNEL32.DLL	記憶體管理、程序/執行緒/同步、檔案 I/O、時間、錯誤處理、模組載入	CreateFile, CreateThread, WaitForSingleObject, VirtualAlloc, LoadLibrary

上層子系統 (Shell32, Comctl32, Ole32, Advapi32, Netapi32, Ws2_32 等) 建構於此三大核心之上。

API 演進里程碑

• Win16 API (16-bit)：Windows 3.x 時代，分段記憶體模型、協作式多工。
• Win32 API (32-bit)：Windows NT/95 起，平坦記憶體、搶佔式多工、Unicode 內碼、安全性/物件管理。
• Win64 API (64-bit)：x64/ARM64 原生，指標擴展至 64-bit，新增 PtrSafe 等屬性，尾碼 `Ptr`/`Handle` 類型變化。
• 現代延伸：WinRT (Windows Runtime) / UWP API (投影至 C++/C#/JS/Rust)、Win32 App SDK (WinUI 3, WebView2) 統一新舊應用模型。

API 設計最佳實踐原則

• 最小驚訝原則：命名一致、行為可預測、錯誤語義清晰。
• 版本管理：語意化版本、向後相容、棄用週期、明確遷移路徑。
• 安全預設：最小權限、輸入驗證、速率限制、審計日誌。
• 可觀測性：標準化追蹤 (W3C TraceContext)、指標 (Prometheus/OpenMetrics)、結構化日誌。