Scalar

Scalar 是一個現代化的開源開發者體驗平台，專為文件化、測試和發現 API 而設計。它提供了一套全面的工具，可將標準的 OpenAPI/Swagger 檔案轉換為世界一流的互動式 API 文件。該平台因其強大的功能、靈活性和以開發者為中心的方法而受到從新創公司到財富 500 強企業的廣泛用戶的信賴。

Scalar 的核心功能是生成美觀且功能強大的 API 參考文件。這些文件不是靜態的；它們包含一個互動式遊樂場，允許開發者和用戶直接在瀏覽器中測試 API 端點。這種文件與測試的無縫整合顯著縮短了上手時間，並簡化了開發工作流程。該平台還包括一個強大的 Swagger 編輯器，使用戶能夠輕鬆預覽、編輯和管理其 OpenAPI 規範。

如何使用 Scalar

開始使用 Scalar 非常簡單。開發者可以首先導入現有的 OpenAPI/Swagger 檔案（支援 3.1、3.0 和 2.0 版本），或使用整合的 Swagger 編輯器從頭開始創建一個。規範載入後，Scalar 會自動生成互動式文件。

為了將 Scalar 整合到專案中，它為眾多框架（如 .NET、Fastify、Next.js、Laravel、Express 等）提供了套件。通常只需一個簡單的指令，例如 dotnet add package Scalar.AspNetCore。然後，開發者可以在其應用程式中添加幾行程式碼，以提供 Scalar API 參考文件。該平台還提供一個獨立的、離線優先的 API 客戶端，適用於 Web、macOS、Linux 和 Windows，可以獨立使用或與文件結合使用，以進行穩健的 API 測試。

Scalar 的核心功能

• 互動式 API 文件： 根據 OpenAPI/Swagger 檔案自動生成美觀、用戶友好的 API 文件，並內建測試遊樂場。
• 整合 API 客戶端： 一個功能強大、離線優先的 REST API 客戶端，可在所有主流桌面平台上使用，用於全面的 API 測試和偵錯。
• Swagger 編輯器： 一個免費的開源工具，可直接在平台內預覽、編輯和管理 Swagger/OAS 檔案。
• 廣泛的客製化： 提供完全的品牌化能力，支援自訂主題、顏色、字體，並能夠添加自訂 CSS/JavaScript，即使在免費方案中也是如此。
• 框架整合： 為各種流行的後端框架（包括 .NET、Nitro、FastAPI、Hono、NestJS 等）提供易於使用的套件。
• Git + Markdown 同步： 允許文件與程式碼並存，支援用 Markdown 編寫並連結到 OpenAPI 檔案的文件。
• 開源核心： 由社群建構並為社群服務，確保透明度、持續改進和無廠商鎖定。
• 程式碼範例生成： 自動生成各種流行程式語言的程式碼範例，以幫助用戶使用 API。

Scalar 的使用案例

Scalar 非常適合任何建立、維護或使用 API 的個人或團隊。一個主要的使用案例是，公司希望為其公共或內部 API 提供卓越的開發者體驗。例如，Supabase、Maersk 和 Tailscale 等公司使用 Scalar 來支援其 API 文件。它也同樣適用於需要快速、簡便地視覺化和測試自己正在開發的 API 的個人開發者。團隊可以使用專業版中的協作功能來同步 API 測試工作區，並確保整個開發生命週期的一致性。

Scalar 的優勢特點

Scalar 的主要優勢在於其將文件和測試無縫整合到一個統一的平台中。與其他將這些功能分開的工具不同，Scalar 允許用戶在閱讀端點資訊後立即進行測試，而無需離開頁面。其開源性質和對 OpenAPI 規範的承諾避免了廠商鎖定。高度的可客製化性使公司能夠保持品牌一致性。此外，其離線優先的 API 客戶端對於需要在沒有持續網際網路連線的情況下工作的開發者來說是一個顯著的好處。慷慨的免費方案使其對所有人開放，而價格合理的專業版則為專業團隊提供了強大的功能。

定價和計劃

Scalar 提供靈活的免費增值定價模式：

• 免費方案： 包括 1 個用戶、無限工作區、免費子網域 (apidocumentation.com)、API 參考、完整的主題和自訂 CSS/JS 樣式，以及內建的 Scalar API 客戶端。
• 專業版（每席位每月 12 美元）： 包括免費方案的所有功能，外加自訂網域、與 GitHub 同步、指南與版本管理、進階搜尋（由 TypeSense 提供支援）和優先支援。
• 企業版（自訂定價）： 包括專業版的所有功能，外加單點登入 (SSO/SAML)、每月文件審計、已驗證的工作區和專屬的 Slack 支援頻道。