我在 .NET 用過 Swashbuckle(已停止更新)、Swagger-NET(fork Swashbuckle)，在 .NET Core，已經不適用了，同時支援 ASP.NET Core 及 OWIN Middleware，通吃 .NET Framework 與 .NET Core 版本的 WebAPI，該是時候準備換掉了...
2020-03-17
2019-02-15
[Swagger] 檔案上傳與下載
原本一直在使用的 Swashbuckle 原來已經不更新，讓下載檔案的功能不正常，改用 Swagger-Net 就可以解決這個問題囉
2019-01-26
[Swagger] 使用 OAuth2 - Resource Owner Password / Implicit flow 測試受保護的 Web API
OAuth2 是目前大廠都有支援的一種授權機制， Swagger 也有支援，我將使用 Resource Owner Password / Implicit flow + Identity Framework 來進行演練。
2019-01-23
[Swagger] 一些 Swagger 編寫文件的技巧和 Client Code Gen
前面幾篇寫了使用 Swagger 的方式，這篇記錄一下編寫文件的技巧以及支援 Client Code Gen 幾種方式
2019-01-21
[Swagger] 使用 Api_Key + JWT 測試受保護的 Web API
Swagger UI 上方有一個 api_key，這次我要利用他加上 JWT 來驗證
2019-01-21
[Swagger] 使用 Basic Auth 測試受保護的 Web API
通常 API 都會經過保護， 當 API 需要授權才能使用時，Swagger 就需要做一些調整才能正常的調用，設定好 Basic Auth 就會有驗證對話視窗
來看看怎麼完成的吧
2019-01-19
[Swagger] 使用 Namespace 作為版本號
預設的情況，Web API 想要用相同的 ClassName 不同的 Namespace 來當成版本 URI 是不行的，幸好這件事不難官方也有提供解法
搬到 Swagger 也不難，只是有一些坑需要踩..
2019-01-19
[Swagger] 解決不支援多個操作行為
Swagger 是個不錯的文檔+測試工具，但是卻不支援多個行為，需要靠它來簡化文件的工作，怎麼辦?
2018-12-20
[Swagger] 在 Swagger UI 新增自訂 Header
用 Swagger UI 進行測試時，預設是沒有 Header 可以用，當 API 需要用到 Header，要自己手動處理一下，讓 Swagger UI 提供畫面讓開發人員調試
2018-09-29
[ASP.NET Web API 2] 使用 Swagger 產生 Web API 文件以及測試站台
Swagger 用來產生文件和即時測試網站，是開發人員的小幫手，再搭配 PostMan 來產生 C# (RestClient)，可以提升整體的開發速度
- 1
- 2