Quarkus 手动设置开放 API Url

Question

所以我知道我可以使用 quarkus.smallrye-openapi.path=/openapi 更改开放 api 路径

但是，我使用的是 api 网关，并且在服务开始时，我使用 https://gateurl/notification/swagger-ui/ 之类的内容来识别它们

如何更改 open api 的 url，这样我就不必每次打开 url 时都手动将 /notification/openapi 放入 swagger 中

Answer 1

您可以使用

quarkus.swagger-ui.urls

设置一个或多个 url。请参阅https://quarkus.io/guides/openapi-swaggerui#quarkus-swaggerui_quarkus.swagger-ui.urls-urls

示例：

quarkus.swagger-ui.urls.default=https://gateurl/notification/swagger-ui/

这将根据需要更改网址。

您还可以添加两者（例如，一个通过网关，一个直接）：

quarkus.swagger-ui.urls.default=https://gateurl/notification/swagger-ui/
quarkus.swagger-ui.urls.direct=/q/openapi
quarkus.swagger-ui.urls-primary-name=default

这将为您提供一个下拉列表，其中默认选择一个网关。

请参阅 https://github.com/phillip-kruger/openapi-example 获取示例。

Answer 2

使用

quarkus.smallrye-openapi.additional-docs-directory=META-INF/

中的设置

application.properties

，所有.json文件都会被发现。