speakeasy-api/speakeasy

解決的問題

Speakeasy 為 API 開發者提供現代化的工具鏈，可自動建立高品質、類型安全的客戶端 SDK、Terraform 提供者與契約測試。它消除了隨著 API 演進，在多種程式語言中手動撰寫與維護這些資產的繁瑣工作。

工作原理

Speakeasy 以 OpenAPI 3.X 規範作為唯一可信來源。它提供一組工具，用於對這些規範進行 lint、清理與編輯（透過 Overlays），然後為 10 多種語言生成精煉、符合語言習慣的 SDK 程式碼、Terraform 提供者，以及由 Arazzo 驅動的契約測試。

適用對象

需要將 API 以多種語言（例如 TypeScript、Python、Go、Java、C#、PHP、Ruby、Unity）分發給使用者，並確保 API 合約被嚴格驗證的 API 提供者與開發者。

主要亮點

• 多語言 SDK：為 10 多種語言生成符合語言習慣、類型安全的程式碼。
• Terraform 提供者：基於類型安全的 Go SDK 自動產生完整的 Terraform 提供者。
• 契約測試：透過預先建構的模擬伺服器產生契約測試。
• OpenAPI 工具鏈：包含用於 lint、diff 和編輯 OpenAPI 規範的工具鏈。
• AI 代理整合：提供「代理技能」，讓 AI 編碼代理（如 Claude Code、Cursor 和 GitHub Copilot）能管理 SDK 專案並驗證規範。