iT邦幫忙

2021 iThome 鐵人賽

DAY 21
0
IT管理

「Google Apps Script」 學習筆記系列 第 21

【Day 21】Google Apps Script - API Blueprint 篇 - API Blueprint 介紹

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 介紹,更多介紹可以參考以下的連結。
 

參考


上一篇
【Day 20】Google Apps Script - API 篇回顧整理
下一篇
【Day 22】Google Apps Script - API Blueprint 篇 - API Blueprint 格式範例
系列文
「Google Apps Script」 學習筆記30

尚未有邦友留言

立即登入留言