重命名端点/openapi和/openapi/ui

Question

使用OpenAPI创建的API文档通常使用端点/openapi (YAML)或/openapi/ui (前端)进行调用。如何重命名这些端点，以便分别调用/myappapi和/myappapi/ui？(OpenAPI 3)

Answer 1

这在很大程度上取决于您是如何生成OpenAPI的。从您的评论中我看到您使用的是Eclipse，而且我以前还没有见过这种情况，但是快速的DuckDuckGo显示这个扩展可能就是您要做的：https://github.com/eclipse/microprofile-open-api

我看不到任何特定的配置选项来更改端点，但您总是可以将nginx重定向到其中。

如果您发现生成OpenAPI的方式存在局限性，那么我建议您不要这样做。

在所有的方法中:注释、DSL、在文本编辑器或GUI中手工编写YAML，我不得不推荐GUI方法，因为它允许首先为新的API和旧API中的新功能设计API。

我刚刚做了一个很大的讨论：https://www.youtube.com/watch?v=nfkppuQ-Eg0&feature=youtu.be

博客版本：https://stoplight.io/blog/api-design-first-vs-code-first/

否则，查看是否可以选择该扩展并调整配置选项，直到它做您想做的任何事情为止。:)