余小章 @ 大內殿堂

通常 API 都會經過保護， 當 API 需要授權才能使用時，Swagger 就需要做一些調整才能正常的調用，設定好 Basic Auth 就會有驗證對話視窗

來看看怎麼完成的吧

預設的情況，Web API 想要用相同的 ClassName 不同的 Namespace 來當成版本 URI 是不行的，幸好這件事不難官方也有提供解法

https://blogs.msdn.microsoft.com/webdev/2013/03/07/asp-net-web-api-using-namespaces-to-version-web-apis/

搬到 Swagger 也不難，只是有一些坑需要踩..
 

Swagger 是個不錯的文檔+測試工具，但是卻不支援多個行為，需要靠它來簡化文件的工作，怎麼辦?

用 Swagger UI 進行測試時，預設是沒有 Header 可以用，當 API 需要用到 Header，要自己手動處理一下，讓 Swagger UI 提供畫面讓開發人員調試

Swagger 用來產生文件和即時測試網站，是開發人員的小幫手，再搭配 PostMan 來產生 C# (RestClient)，可以提升整體的開發速度