Swashbuckle 可以連接到 SwaggerHub 嗎？

Question

（Api 文檔的新手）

我對 SwaggerUI 和 SwaggerHub 之間的區別有些困惑。

目前我有一個 C# Asp.net Web API 代碼，Swashbuckle.AspNetCore 正在讀取代碼，並且在 Swagger UI 上記錄了該 API。 我采用了代碼優先的方法，因為一切都已經編碼。 但是，我希望在 SwaggerHub 中記錄我的 API。

我目前還沒有在網上找到任何解決方案。

這是可能的，我該如何去做？

Answer 1

這是非常容易實現的。

一旦您的文檔由 Swashbuckle 生成，您所需要做的就是將文檔“推送”到您的 SwaggerHub 實例。 您可以使用以下兩種工具之一來執行此操作：

SwaggerHub CLI 中的create或update命令： https : //github.com/SmartBear/swaggerhub-cli

來自 SwaggerHub 的注冊表 API 的POST /apis/{owner}/{api}端點： https ://app.swaggerhub.com/apis-docs/swagger-hub/registry-api/1.0.62#/APIs/saveDefinition

使用這兩個工具，您可以以編程方式將文檔從構建環境發送到 SwaggerHub（以及許多其他很酷的東西！）。