給WebAPI的REST接口服務添加測試頁面（一）

當使用WebAPI提供REST服務的時候，一個常常進行的操做是對接口進行測試。Asp.net WebAPI框架自己並無提供這一接口，不過因爲提供的是標準的REST服務，是能夠很是方便的使用一些第三方的工具的。

我以前常常用的Chrome的Postman插件來進行測試，它能夠用來模擬各類Http請求操做。雖然這個工具也算好用，不過因爲它只是一個通用的工具，使用它的時候要構建Http報文頭，並根據具體API組裝消息體，這也是一件比較麻煩的事情。

今天網上閒逛的時候發現了一個更加好用的測試工具Swagger-UI，它專門針對REST接口提供了很是友好的測試界面：

不只能提供接口列表，還能讀取接口的參數列表，提供友好的配置接口：

接口說明，參數說明，參數類型都能都都出來，很是友好，甚至連參數的各個字段的註釋都能標記出來，基本上都是一個很是友好的幫助文檔了。

更多的示例能夠參考它官方Demo：http://petstore.swagger.io/。 用它來進行測試很是簡單，直接輸入參數就好了，不用費力的構造各類URL和報文，比Postman方便多了。

因爲篇幅所限，本文這裏就只對Swagger-UI進行了一些簡單的介紹，下篇文章中再詳細介紹如何將Swagger-UI集成到WebAPI中。