【问题标题】:Rename endpoint /openapi and /openapi/ui重命名端点 /openapi 和 /openapi/ui
【发布时间】:2026-01-02 00:15:02
【问题描述】:

使用 OpenAPI 创建的 API 文档通常使用端点 /openapi (YAML) 或 /openapi/ui (Frontend) 调用。 我如何重命名这些端点,我可以调用例如/myappapi/myappapi/ui 分别是? (OpenAPI 3)

【问题讨论】:

  • 您使用什么服务器端框架 - Springfox、Swashbuckle、Swagger-Net、Swagger-PHP 等等?
  • 我使用 Eclipse MicroProfile

标签: swagger openapi microprofile


【解决方案1】:

这在很大程度上取决于您生成该 OpenAPI 的方式。从您的评论中,我看到您正在使用 Eclipse MicroProfile,而我以前没有遇到过,但是快速 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/

否则,请查看您是否可以选择该扩展并调整配置选项,直到它执行您想要的任何操作。 :)

【讨论】: