Question

我正在使用akka-http（scala）开发微服务。目前，我找不到任何直接的swagger整合到akka-http中。不过，我正在以swagger 2.0规格开始我的微服务。

现在的挑战之一是向消费应用程序显示整合的API规范。我不想向消费者分享多个规格，因此想要将多个swagger规范聚合成一个单一的规范（如果这可以在运行中完成，那就太棒了）。另外，如何使用swagger-ui？

Answer 1

我建议尽可能多地使用操作引用：

Args

许多人构建简单的路由器将规范组合成单个路由器，这可能非常强大：

paths:
  health:
    $ref: "path/to/your/operation.json"

如果你有一个有效的spec文件，那么swagger-ui就可以了。对于非常大的规格加载缓慢存在一些已知问题，但考虑到错误不是swagger-ui的限制（意味着它将被修复）。