[Web API] 如何讓 Web API 統一回傳格式以及例外處理


當我們在開發 Web API 時,一般的情況下每個 API 回傳的資料型態或格式都不盡相同,如果你的專案從頭到尾都是由你一個人獨力完成,那也許還可以說聲「阿密陀佛」,但如果是有其他人需要和你共享你的 Api ,而回傳的資料格式又不一樣,相信是會增加使用者的困擾,也大大增加了程式的複雜度與維護上的難度。所以本篇也紀錄一下自己在實作上的經驗,一方面留個紀錄也希望幫助更多人,廢物不多說我們開始吧!

...繼續閱讀 »

[WebAPI] 如何在 ASP.NET MVC 專案加上 Web API 說明文件


我們使用 Web API 來開發專案的需求越來越平凡,而相對的 API 的說明文件也就顯得格外重要,才能讓開發 Service 的人員以及 APP 的開發人員能有一個溝通的地方,微軟在 Visual Studio 2012 Update 2 之後,當建立 ASP.NET MVC 專案選擇 Web API 時也將說明文件內建在範本中,而這篇將教你如何在非內建的情況下,手動加入 Web API 的說明文件。

...繼續閱讀 »