Swagger 是一套 API 互動文件產生器，使用 HTML 與 Javascript 所編寫的，與之前所介紹的 ASP.NET Web API Help Page 不同的是，Swagger 是一套 Open Source Software，支援了現在許多的 REST API，之所以會說這是一個互動的文件，除了顯示 API 輸出入規格外，也能夠讓使用者即時的在 Swagger UI 介面上進行操作，立刻就能看到執行結果。
這一篇將會簡單說明如何在一個 ASP.NET Web API 專案裡加入 Swagger 功能。
這個功能的主題其實有很多人都寫過了，不過為了之後的文章，所以還是要先寫出這一篇。
大家也都知道 ASP.NET Web Api 2 都已經有內建了 Help Page 的功能，這是一個可以產生對應 API 服務的線上文件產生器，所謂的產生並不是可以幫我們做出一份 Word 或是 PDF 檔，而是指將我們所開發的 API 服務相關的輸入、輸出、Resource 等資料經由 Help Page 的功能處理並建立好網頁，在網頁上去提供了這些 API 服務的相關資訊，以方便介接 API 服務的開發人員查看。
這一篇就來簡單地介紹如何在 ASP.NET Web Api 應用服務裡啟用這一個功能。
因為這一年來主要都是在開發 ASP.NET Web Api 專案，Client 端的開發測試工具是使用「Postman」，而我也並非第一次在專案開發裡使用，在這幾年的開發裡都有使用到，只不過這次的角色從介接使用別人所開發的 Web Api 變成開發別人要使用的 Web Api，其實不管哪一種角色，使用這類的工具如何可以更加地瞭解如何應用，那麼就會省下很多很多的時間，而這一篇所要講的就是 Postman 所提供的一個功能「Generate Code Snippet」。