【问题标题】:Can Swashbuckle connect to SwaggerHub?Swashbuckle 可以连接到 SwaggerHub 吗?
【发布时间】:2020-08-28 03:54:18
【问题描述】:

(Api 文档新手)

我对 SwaggerUI 和 SwaggerHub 之间的区别有些困惑。

目前我有一个 C# Asp.net Web API 代码,Swashbuckle.AspNetCore 正在读取代码,并且 API 正在 Swagger UI 上记录。 我采用了代码优先的方法,因为所有内容都已编码。但是,我希望在 SwaggerHub 中记录我的 API。

我目前在网上没有找到任何解决方案。

这可能吗?我该怎么做?

【问题讨论】:

    标签: c# asp.net-web-api swagger swagger-ui swashbuckle.aspnetcore


    【解决方案1】:

    这非常容易实现。

    一旦您的文档由 Swashbuckle 生成,您所需要做的就是将文档“推送”到您的 SwaggerHub 实例。您可以使用以下两种工具之一来执行此操作:

    来自 SwaggerHub CLI 的 createupdate 命令: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(以及许多其他很酷的东西!)。

    【讨论】:

      猜你喜欢
      • 2021-12-17
      • 2020-12-25
      • 2022-06-23
      • 2023-03-21
      • 2018-12-27
      • 2020-02-02
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      相关资源
      最近更新 更多