![[apiary][06]設計API時好用的工具 - 讓前後端溝通格式不再卡卡 - 前端如何使用mock server以及inspector來開發.jpg](/posts/2019/04/2019-04-07-apiary-how-to-use-the-mock-server-and-interceptor-for-debugging/308c78ea-5345-4135-b998-db6ef211956a.jpg)
在上一篇([apiary][05]設計API時好用的工具 - 讓前後端溝通格式不再卡卡 - MSON格式篇)介紹完了MSON之後，基本上要寫出一個API格式的文件就沒什麽問題。
當API定義出來了之後，Apiary會自動建立出一個mock server，前端這個時候就可以呼叫這個mock server做初步的開發。
同時間，後端就可以依照定義好的API文件開始去開發。
理論上來説，只要前端和後端都依照同一份開發，那麽最後只需兩邊好了的時候做一個整合測試，那麽整體功能就完成了。
這篇來看看前端呼叫mock server的方式。
![[apiary][05]設計API時好用的工具 - 讓前後端溝通格式不再卡卡 - MSON格式篇.jpg](/posts/2019/04/2019-04-05-apiary-what-is-mson-and-how-to-use-it/58aeef1b-f409-4e6a-9a7b-1f49801ceca7.jpg)
在上一篇([apiary][04]設計API時好用的工具 - 讓前後端溝通格式不再卡卡 - API Blueprint Actions格式篇)介紹了如何定義Actions，換句話説，以目前的知識要定義出一個API已經沒有什麽問題了。
但是在上一篇還有遇到一個問題，那就是不管是request或者response的JSON物件沒有定義出來裡面的欄位以及説明。換句話説，目前的方式只有範例，但是每一個欄位的形態，描述沒有辦法定義。
Apiary團隊當初考慮到了這一個問題，因此建立出一個格式稱之爲Markdown Syntax for Object Notation (MSON)，專門用來描述JSON以及JSON Schema。
這邊來看看MSON怎麽使用。
![[apiary][04]設計API時好用的工具 - 讓前後端溝通格式不再卡卡 - API Blueprint Actions格式篇.jpg](/posts/2019/04/2019-04-02-apiary-understand-the-structure-of-actions-and-define-request-and-response/c524b087-b496-45d3-99dd-0b6fcf43445f.jpg)
在上一篇 ([apiary][03]設計API時好用的工具 - 讓前後端溝通格式不再卡卡 - API Blueprint基本結構介紹篇) 瞭解了整個API Blueprint的基本結構之後，對於整個文件的架構應該有個比較充分的瞭解了。
但是上一篇因爲篇幅的關係，跳過了Actions裡面定義的部分。
Actions是什麽呢？基本上Actions就在定義某一之API可以接受的Request和Response是什麽。
這篇來看看怎麽定義。
![[apiary][03]設計API時好用的工具 - 讓前後端溝通格式不再卡卡 - API Blueprint基本結構介紹篇.jpg](/posts/2019/03/2019-03-26-apiary-understand-the-structure-of-api-blueprint/fe1947f8-5755-4943-9239-25b4dd24113c.jpg)
在上一篇 ([apiary][02]設計API時好用的工具 - 讓前後端溝通格式不再卡卡 - 工具使用介紹篇) 瞭解了怎麽使用apiary這一個工具來撰寫api的文件之後。
在這一篇將來實際的撰寫看看感覺如何。
之前提到過apiary預設的文件格式是API Blueprint，因此這一篇將來看看API Blueprint怎麽使用，並且看看撰寫起來感覺如何。
_1477.png)
_1485.png)
_1486.png)