API Blueprint(藍圖)。一種用於 Web API 的強大的高級 API 描述語言。API 藍圖很簡單，而且 API 生命週期中涉及的每個人都可以訪問。它的語法簡潔而富有表現力。借助 API Blueprint，您可以快速設計要創建的 API 和原型，或者記錄和測試已部署的關鍵任務 API。-by apiblueprint.org。

今日要點：
》API Blueprint 介紹

API Blueprint 介紹

API Blueprint 是一種 RESTful API 描述語言，撰寫容易快速，它採用 MSON，MSON 是 Markdown Syntax for Object Notation 的縮寫，它是一種以人類可讀的純文本形式表示數據結構的方法。API Blueprint 在 2013 年開始發展，開放程式碼採 MIT license，在 2017 年被 Oracle 收購，可以使用 Apiary 或 Aglio 來把 API Blueprint 視覺化。

API Blueprint 幾個特色整理：

• 副檔名：.apib
• Markdown：參加鐵人賽的大家應該都對 Markdown 很熟了，API Blueprint 比較關注文件上，用的是以 Markdown 為基礎再加上特別的語法，所以在首頁上還強調 "high-level API 描述語言"。
• 開放程式碼： MIT license，在 github 上有 8.3K 個星星
• Apiary：框架和工具服務網站，可以幫助設置模擬服務，也有免費的服務不過免費的 API 文件只能設定公開訪問，在2017年 Oracle 收購了 Apiary。
• Aglio：具有主題支持的 API Blueprint 渲染器，可輸出靜態 HTML。

目前最活躍的有這種的 API 描述語言：

• API Blueprint (Markdown-like)
• RAML (YAML-like)
• OpenAPI Swagger (YAML-like)

以上是目前整理出的 API Blueprint 介紹，更多介紹可以參考以下的連結。
　

參考

• Overview of RESTful API Description Languages
• OpenAPI Specification
• A Short History of OAI and API Specifications
• API Blueprint
• help.apiary.io
• Github apiaryio/api-blueprint
• Github api-blueprint/examples/
• Swagger vs API Blueprint for API documentation
• API Blueprint: Markdown is awesome!
• 用 Aglio 做出漂亮的 API 文件