将 Swagger 与现有 API 集成

Question

有没有办法只自动生成文档和客户端 UI 以与我已经创建的现有 Go 服务进行交互？

API 服务的自动生成代码的唯一问题是我有两种类型的支持传输（gRPC 和 http）。我不想局限于自动生成的 Swagger 服务器。

Answer 1

一旦您的 HTTP 服务实现与收集文档的工具兼容，这将成为可能。

例如，您可以在代码中添加魔法 cmets 并使用 https://goswagger.io/generate/spec.html。

或者，您也可以重构您的 http 处理程序和路由器设置以匹配 https://github.com/swaggest/rest 的约定并反映规范。