一覧に戻る

バージョン:

OpenAPIとSwagger UIの利用

前提条件
アーキテクチャ
ソリューション
Mavenプロジェクトの作成
RESTリソースを公開する
OpenAPI仕様を公開
アプリケーションレベルのOpenAPIアノテーションの提供
静的ファイルからの OpenAPI スキーマのロード
OpenAPIのバージョン変更
操作IDの自動生成
開発にSwagger UIを使用する
- スタイリング
- クロスオリジンリソース共有
設定リファレンス
- OpenAPI
- Swagger UI

このガイドでは、QuarkusアプリケーションがOpenAPI仕様でAPIの説明を公開する方法と、Swagger UIというユーザーフレンドリーなUIを介してテストする方法について説明します。

前提条件

このガイドを完成させるには、以下が必要です:

約15分
IDE
JDK 11+ がインストールされ、 JAVA_HOME が適切に設定されていること
Apache Maven 3.9.1
使用したい場合は、 Quarkus CLI
ネイティブ実行可能ファイルをビルドしたい場合、MandrelまたはGraalVM（あるいはネイティブなコンテナビルドを使用する場合はDocker）をインストールし、適切に設定していること

アーキテクチャ

このガイドでは、API の仕様をいかに早く公開し、ユーザーインターフェイスから利益を得てテストできるかを実証するために、簡単な REST アプリケーションを作成します。

ソリューション

次のセクションで紹介する手順に沿って、ステップを踏んでアプリを作成することをお勧めします。ただし、直ぐに完成した例に飛ばしても構いません。

Gitレポジトリをクローンするか git clone https://github.com/quarkusio/quarkus-quickstarts.git 、アーカイブをダウンロードします。

ソリューションは openapi-swaggerui-quickstart ディレクトリにあります。

Mavenプロジェクトの作成

まず、新しいプロジェクトが必要です。以下のコマンドで新規プロジェクトを作成します。

コマンドラインインタフェース

quarkus create app org.acme:openapi-swaggerui-quickstart \
    --extension='resteasy-reactive-jackson' \
    --no-code
cd openapi-swaggerui-quickstart

Gradleプロジェクトを作成するには、 --gradle または --gradle-kotlin-dsl オプションを追加します。

Quarkus CLIのインストール方法や使用方法については、 Quarkus CLIガイドを参照してください。

Maven

mvn io.quarkus.platform:quarkus-maven-plugin:3.1.0.Final:create \
    -DprojectGroupId=org.acme \
    -DprojectArtifactId=openapi-swaggerui-quickstart \
    -Dextensions='resteasy-reactive-jackson' \
    -DnoCode
cd openapi-swaggerui-quickstart

Gradleプロジェクトを作成するには、 -DbuildTool=gradle または -DbuildTool=gradle-kotlin-dsl オプションを追加します。

RESTリソースを公開する

ここでは、 Fruit Beanと FruitResouce RESTリソースを作成します（QuarkusでREST APIを構築する方法について詳しく知りたい場合は、 Writing JSON REST servicesガイドを参照してください）。

package org.acme.openapi.swaggerui;

public class Fruit {

    public String name;
    public String description;

    public Fruit() {
    }

    public Fruit(String name, String description) {
        this.name = name;
        this.description = description;
    }
}

package org.acme.openapi.swaggerui;

import jakarta.ws.rs.GET;
import jakarta.ws.rs.POST;
import jakarta.ws.rs.DELETE;
import jakarta.ws.rs.Path;
import java.util.Collections;
import java.util.LinkedHashMap;
import java.util.Set;

@Path("/fruits")
public class FruitResource {

    private Set<Fruit> fruits = Collections.newSetFromMap(Collections.synchronizedMap(new LinkedHashMap<>()));

    public FruitResource() {
        fruits.add(new Fruit("Apple", "Winter fruit"));
        fruits.add(new Fruit("Pineapple", "Tropical fruit"));
    }

    @GET
    public Set<Fruit> list() {
        return fruits;
    }

    @POST
    public Set<Fruit> add(Fruit fruit) {
        fruits.add(fruit);
        return fruits;
    }

    @DELETE
    public Set<Fruit> delete(Fruit fruit) {
        fruits.removeIf(existingFruit -> existingFruit.name.contentEquals(fruit.name));
        return fruits;
    }
}

テストを作成することもできます。

package org.acme.openapi.swaggerui;

import io.quarkus.test.junit.QuarkusTest;
import org.junit.jupiter.api.Test;

import jakarta.ws.rs.core.MediaType;

import static io.restassured.RestAssured.given;
import static org.hamcrest.CoreMatchers.is;
import static org.hamcrest.Matchers.containsInAnyOrder;

@QuarkusTest
public class FruitResourceTest {

    @Test
    public void testList() {
        given()
                .when().get("/fruits")
                .then()
                .statusCode(200)
                .body("$.size()", is(2),
                        "name", containsInAnyOrder("Apple", "Pineapple"),
                        "description", containsInAnyOrder("Winter fruit", "Tropical fruit"));
    }

    @Test
    public void testAdd() {
        given()
                .body("{\"name\": \"Pear\", \"description\": \"Winter fruit\"}")
                .header("Content-Type", MediaType.APPLICATION_JSON)
                .when()
                .post("/fruits")
                .then()
                .statusCode(200)
                .body("$.size()", is(3),
                        "name", containsInAnyOrder("Apple", "Pineapple", "Pear"),
                        "description", containsInAnyOrder("Winter fruit", "Tropical fruit", "Winter fruit"));

        given()
                .body("{\"name\": \"Pear\", \"description\": \"Winter fruit\"}")
                .header("Content-Type", MediaType.APPLICATION_JSON)
                .when()
                .delete("/fruits")
                .then()
                .statusCode(200)
                .body("$.size()", is(2),
                        "name", containsInAnyOrder("Apple", "Pineapple"),
                        "description", containsInAnyOrder("Winter fruit", "Tropical fruit"));
    }
}

OpenAPI仕様を公開

Quarkusでは、APIの OpenAPI v3仕様を生成するために、 MicroProfile OpenAPI仕様に準拠した Smallrye OpenAPIエクステンションを提供しています。

Quarkusアプリケーションに openapi のエクステンションを追加するだけです。

コマンドラインインタフェース

quarkus extension add 'quarkus-smallrye-openapi'

Maven

./mvnw quarkus:add-extension -Dextensions='quarkus-smallrye-openapi'

Gradle

./gradlew addExtension --extensions='quarkus-smallrye-openapi'

これにより、ビルドファイルに以下が追加されます:

pom.xml

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-smallrye-openapi</artifactId>
</dependency>

build.gradle

implementation("io.quarkus:quarkus-smallrye-openapi")

これで、アプリケーションを実行する準備が整いました。

コマンドラインインタフェース

quarkus dev

Maven

./mvnw quarkus:dev

Gradle

./gradlew --console=plain quarkusDev

アプリケーションを起動すると、デフォルトの /q/openapi エンドポイントにリクエストを行うことができます。

$ curl http://localhost:8080/q/openapi
openapi: 3.0.3
info:
  title: Generated API
  version: "1.0"
paths:
  /fruits:
    get:
      responses:
        200:
          description: OK
          content:
            application/json: {}
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Fruit'
      responses:
        200:
          description: OK
          content:
            application/json: {}
    delete:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Fruit'
      responses:
        200:
          description: OK
          content:
            application/json: {}
components:
  schemas:
    Fruit:
      properties:
        description:
          type: string
        name:
          type: string

あなたがデフォルトのエンドポイントの場所 /q/openapi を好きではない場合 , あなたの application.properties に次の設定を追加することで、場所を変更することができます .

quarkus.smallrye-openapi.path=/swagger

OpenAPIをJSON形式でリクエストするには、 format クエリパラメータを使用します。例えば、以下のようになります。

/q/openapi?format=json

CTRL+C を叩いてアプリケーションを停止させます。

アプリケーションレベルのOpenAPIアノテーションの提供

以下のようなグローバルAPI情報を記述するMicroProfile OpenAPIアノテーションがあります。

APIタイトル
APIの説明
バージョン
連絡先情報
ライセンス

Jakarta REST Application クラスで適切な OpenAPI アノテーションを使用することで、これらの情報（や、それ以上）をすべて Java コードに含めることができます。Jakarta REST Application クラスは Quarkus では必須ではないため、作成する必要がある場合があります。このクラスは、 jakarta.ws.rs.core.Application を拡張した空のクラスとすることができます。この空のクラスには、 @OpenAPIDefinition などのさまざまな OpenAPI アノテーションを付けることができます。例えば、次のようになります:

@OpenAPIDefinition(
    tags = {
            @Tag(name="widget", description="Widget operations."),
            @Tag(name="gasket", description="Operations related to gaskets")
    },
    info = @Info(
        title="Example API",
        version = "1.0.1",
        contact = @Contact(
            name = "Example API Support",
            url = "http://exampleurl.com/contact",
            email = "techsupport@example.com"),
        license = @License(
            name = "Apache 2.0",
            url = "https://www.apache.org/licenses/LICENSE-2.0.html"))
)
public class ExampleApiApplication extends Application {
}

SmallRyeが提供する機能で、仕様には含まれていませんが、このグローバルAPI情報を追加するために、設定を使用するという方法もあります。この方法では、jakarta REST Application クラスを用意する必要がなく、環境ごとに異なるAPI名を付けることができます。

例えば、次を application.properties に追加して下さい。

quarkus.smallrye-openapi.info-title=Example API
%dev.quarkus.smallrye-openapi.info-title=Example API (development)
%test.quarkus.smallrye-openapi.info-title=Example API (test)
quarkus.smallrye-openapi.info-version=1.0.1
quarkus.smallrye-openapi.info-description=Just an example service
quarkus.smallrye-openapi.info-terms-of-service=Your terms here
quarkus.smallrye-openapi.info-contact-email=techsupport@example.com
quarkus.smallrye-openapi.info-contact-name=Example API Support
quarkus.smallrye-openapi.info-contact-url=http://exampleurl.com/contact
quarkus.smallrye-openapi.info-license-name=Apache 2.0
quarkus.smallrye-openapi.info-license-url=https://www.apache.org/licenses/LICENSE-2.0.html

これにより、上記の @OpenAPIDefinition の例と同様の情報が得られます。

静的ファイルからの OpenAPI スキーマのロード

Quarkusでは、アノテーションスキャンからOpenAPIスキーマを動的に作成する代わりに、静的なOpenAPIドキュメントの配信もサポートしています。サーブする静的ファイルは、 OpenAPI仕様に準拠した有効なドキュメントである必要があります。OpenAPI仕様に準拠したOpenAPIドキュメントは、それ自体が有効なJSONオブジェクトであり、 yaml または json 形式で表現できます。

この動作を確認するために、 /fruits のエンドポイントについて、OpenAPIドキュメントを META-INF/openapi.yaml の下に置いてみます。希望に応じて、Quarkusは OpenAPIドキュメントの代替パスもサポートしています。

openapi: 3.0.1
info:
  title: Static OpenAPI document of fruits resource
  description: Fruit resources Open API documentation
  version: "1.0"

servers:
  - url: http://localhost:8080/q/openapi
    description: Optional dev mode server description

paths:
  /fruits:
    get:
      responses:
        200:
          description: OK - fruits list
          content:
            application/json: {}
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Fruit'
      responses:
        200:
          description: new fruit resource created
          content:
            application/json: {}
    delete:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Fruit'
      responses:
        200:
          description: OK - fruit resource deleted
          content:
            application/json: {}
components:
  schemas:
    Fruit:
      properties:
        description:
          type: string
        name:
          type: string

デフォルトでは、 /q/openapi へのリクエストは、静的ファイルとアプリケーションエンドポイントコードから生成されたモデルを組み合わせた OpenAPI ドキュメントを提供します。しかし、 application.properties に mp.openapi.scan.disable=true 設定を追加することで、静的な OpenAPI ドキュメントのみを提供するように変更することができます。

これで、 /q/openapi エンドポイントへのリクエストは、生成されたものではなく静的な OpenAPI ドキュメントを提供するようになりました。

OpenAPIドキュメントパスについて

Quarkusは、OpenAPIドキュメントを保存するためのさまざまなパスをサポートしています。 META-INF/openapi.yml 以下に配置することをお勧めします。代替パスは以下の通りです。

META-INF/openapi.yaml
META-INF/openapi.yml
META-INF/openapi.json
WEB-INF/classes/META-INF/openapi.yml
WEB-INF/classes/META-INF/openapi.yaml
WEB-INF/classes/META-INF/openapi.json

開発中は、静的なOpenAPIドキュメントのライブリロードがサポートされています。OpenAPIドキュメントへの変更は、Quarkusによって起動中にピックアップされます。

OpenAPIのバージョン変更

デフォルトでは、ドキュメント生成時に使用されるOpenAPIのバージョンは 3.0.3 です。上記のように静的ファイルを使用する場合は、そのファイルのバージョンが使用されます。また、以下の設定でSmallRyeでバージョンを定義することもできます。

mp.openapi.extensions.smallrye.openapi=3.0.2

これは、あなたのAPIが特定のバージョンを必要とするゲートウェイを経由する場合に便利です。

操作IDの自動生成

Operation Idは @Operation アノテーションを使って設定することができ、ツールを使ってスキーマからクライアント・スタブを生成する際に多くの場合役立ちます。Operation Idは通常、クライアントスタブのメソッド名に使用されます。SmallRyeでは、以下のような設定でこのOperation Idを自動生成することができます。

mp.openapi.extensions.smallrye.operationIdStrategy=METHOD

これで、 @Operation アノテーションを使用する必要はありません。ドキュメントの生成時には、メソッド名がオペレーションIDとして使用されます。

Table 1. 操作Idを生成するために利用可能な戦略
プロパティ値	説明
`METHOD`	メソッド名を使用します。
`CLASS_METHOD`	(パッケージを含まない)クラス名とメソッドを使用します。
`PACKAGE_CLASS_METHOD`	クラス名とメソッド名を使用します。

開発にSwagger UIを使用する

APIを構築する際、開発者は素早くテストしたいと考えています。 Swagger UI は、APIを視覚化して対話するための素晴らしいツールです。UIはOpenAPI仕様から自動的に生成されます。

Quarkus smallrye-openapi エクステンションには、適切に設定されたSwagger UIページを埋め込む swagger-ui エクステンションが付属しています。

デフォルトでは、Swagger UIは、Quarkusを開発モードまたはtestモードで起動したときにのみ使用できます。

本番環境でも利用できるようにしたい場合は、以下の設定を application.properties に追加してください。

quarkus.swagger-ui.always-include=true

これはビルド時プロパティーで、アプリケーションがビルドされた後、ランタイムに変更することはできません。

デフォルトでは、Swagger UIは /q/swagger-ui でアクセス可能です。

application.properties の quarkus.swagger-ui.path プロパティーを設定することで、 /swagger-ui サブパスを更新することができます。

quarkus.swagger-ui.path=my-custom-path

値 / は、アプリケーションが他のサービスを提供できないようにブロックするため、許可されません。値の前に「/」を付けると、相対値ではなく絶対値になります。

これで、アプリケーションを実行する準備が整いました。

./mvnw compile quarkus:dev

アプリケーションのログでSwaggerのUIパスを確認することができます。

00:00:00,000 INFO  [io.qua.swa.run.SwaggerUiServletExtension] Swagger UI available at /q/swagger-ui

アプリケーションが起動したら、 http://localhost:8080/q/swagger-ui にアクセスしてAPIで遊ぶことができます。

APIの操作やスキーマを可視化することができます。 Visualize your API

また、APIを素早くテストするためにAPIと対話することもできます。 Interact with your API

CTRL+C を叩いてアプリケーションを停止させます。

スタイリング

独自のロゴやCSSを供給することで、swagger uiをスタイリングすることができます。

ロゴマーク

独自のロゴを提供するには、 logo.png というファイルを src/main/resources/META-INF/branding に配置する必要があります。

これにより、（swagger uiだけでなく）すべてのUIのロゴが設定されるので、ここではGraphQL-UIやHealth-UI（含まれている場合）も設定されます。

このロゴをswagger-uiだけに適用したい（すべてのUIにグローバルに適用したくない）場合は、 logo.png ではなく smallrye-open-api-ui.png というファイルを呼び出します。

CSS

HTMLのスタイルをオーバーライド/強化する独自のCSSを提供するには、 src/main/resources/META-INF/branding の中に style.css というファイルを置く必要があります。

これにより、（swagger uiだけでなく）すべてのUIにそのCSSが追加されます。この場合、（含まれていれば）GraphQL-UIやHealth-UIにも追加されます。

このスタイルをswagger-uiだけに適用したい（すべてのUIにグローバルに適用したくない）場合は、 style.css ではなく smallrye-open-api-ui.css というファイルを呼び出します。

スタイリングの詳細については、このブログのエントリーをお読みください https://quarkus.io/blog/stylish-api/

クロスオリジンリソース共有

別のドメインで動作する Single Page Application からこのアプリケーションを利用する場合は、CORS (Cross-Origin Resource Sharing) を設定する必要があります。詳細については、 HTTP CORSのドキュメントを参照してください。

設定リファレンス

OpenAPI

ビルド時に固定される設定プロパティ - その他の設定プロパティは実行時にオーバーライド可能です。

Configuration property	型	デフォルト
`quarkus.smallrye-openapi.path` The path at which to register the OpenAPI Servlet. Environment variable: `QUARKUS_SMALLRYE_OPENAPI_PATH`	string	`openapi`
`quarkus.smallrye-openapi.store-schema-directory` If set, the generated OpenAPI schema documents will be stored here on build. Both openapi.json and openapi.yaml will be stored here if this is set. Environment variable: `QUARKUS_SMALLRYE_OPENAPI_STORE_SCHEMA_DIRECTORY`	path
`quarkus.smallrye-openapi.always-run-filter` Do not run the filter only at startup, but every time the document is requested (dynamic). Environment variable: `QUARKUS_SMALLRYE_OPENAPI_ALWAYS_RUN_FILTER`	boolean	`false`
`quarkus.smallrye-openapi.ignore-static-document` Do not include the provided static openapi document (eg. META-INF/openapi.yaml) Environment variable: `QUARKUS_SMALLRYE_OPENAPI_IGNORE_STATIC_DOCUMENT`	boolean	`false`
`quarkus.smallrye-openapi.additional-docs-directory` A list of local directories that should be scanned for yaml and/or json files to be included in the static model. Example: `META-INF/openapi/` Environment variable: `QUARKUS_SMALLRYE_OPENAPI_ADDITIONAL_DOCS_DIRECTORY`	list of path
`quarkus.smallrye-openapi.security-scheme` Environment variable: `QUARKUS_SMALLRYE_OPENAPI_SECURITY_SCHEME`	`api-key`, `basic`, `jwt`, `oauth2`, `oidc`, `oauth2-implicit`
`quarkus.smallrye-openapi.security-scheme-name` Add a Security Scheme name to the generated OpenAPI document Environment variable: `QUARKUS_SMALLRYE_OPENAPI_SECURITY_SCHEME_NAME`	string	`SecurityScheme`
`quarkus.smallrye-openapi.security-scheme-description` Add a description to the Security Scheme Environment variable: `QUARKUS_SMALLRYE_OPENAPI_SECURITY_SCHEME_DESCRIPTION`	string	`Authentication`
`quarkus.smallrye-openapi.auto-add-security-requirement` This will automatically add the security requirement to all methods/classes that has a `RolesAllowed` annotation. Environment variable: `QUARKUS_SMALLRYE_OPENAPI_AUTO_ADD_SECURITY_REQUIREMENT`	boolean	`true`
`quarkus.smallrye-openapi.auto-add-tags` This will automatically add tags to operations based on the Java class name. Environment variable: `QUARKUS_SMALLRYE_OPENAPI_AUTO_ADD_TAGS`	boolean	`true`
`quarkus.smallrye-openapi.auto-add-server` Setting it to `true` will automatically add a default server to the schema if none is provided, using the current running server host and port. Environment variable: `QUARKUS_SMALLRYE_OPENAPI_AUTO_ADD_SERVER`	boolean
`quarkus.smallrye-openapi.auto-add-security` This will automatically add security based on the security extension included (if any). Environment variable: `QUARKUS_SMALLRYE_OPENAPI_AUTO_ADD_SECURITY`	boolean	`true`
`quarkus.smallrye-openapi.api-key-parameter-in` Required when using `apiKey` security. The location of the API key. Valid values are "query", "header" or "cookie". Environment variable: `QUARKUS_SMALLRYE_OPENAPI_API_KEY_PARAMETER_IN`	string
`quarkus.smallrye-openapi.api-key-parameter-name` Required when using `apiKey` security. The name of the header, query or cookie parameter to be used. Environment variable: `QUARKUS_SMALLRYE_OPENAPI_API_KEY_PARAMETER_NAME`	string
`quarkus.smallrye-openapi.basic-security-scheme-value` Add a scheme value to the Basic HTTP Security Scheme Environment variable: `QUARKUS_SMALLRYE_OPENAPI_BASIC_SECURITY_SCHEME_VALUE`	string	`basic`
`quarkus.smallrye-openapi.jwt-security-scheme-value` Add a scheme value to the JWT Security Scheme Environment variable: `QUARKUS_SMALLRYE_OPENAPI_JWT_SECURITY_SCHEME_VALUE`	string	`bearer`
`quarkus.smallrye-openapi.jwt-bearer-format` Add a bearer format the JWT Security Scheme Environment variable: `QUARKUS_SMALLRYE_OPENAPI_JWT_BEARER_FORMAT`	string	`JWT`
`quarkus.smallrye-openapi.oauth2-security-scheme-value` Add a scheme value to the OAuth2 opaque token Security Scheme Environment variable: `QUARKUS_SMALLRYE_OPENAPI_OAUTH2_SECURITY_SCHEME_VALUE`	string	`bearer`
`quarkus.smallrye-openapi.oauth2-bearer-format` Add a scheme value to OAuth2 opaque token Security Scheme Environment variable: `QUARKUS_SMALLRYE_OPENAPI_OAUTH2_BEARER_FORMAT`	string	`Opaque`
`quarkus.smallrye-openapi.oidc-open-id-connect-url` Add a openIdConnectUrl value to the OIDC Security Scheme Environment variable: `QUARKUS_SMALLRYE_OPENAPI_OIDC_OPEN_ID_CONNECT_URL`	string
`quarkus.smallrye-openapi.oauth2-implicit-refresh-url` Add a implicit flow refreshUrl value to the OAuth2 Security Scheme Environment variable: `QUARKUS_SMALLRYE_OPENAPI_OAUTH2_IMPLICIT_REFRESH_URL`	string
`quarkus.smallrye-openapi.oauth2-implicit-authorization-url` Add an implicit flow authorizationUrl value to the OAuth2 Security Scheme Environment variable: `QUARKUS_SMALLRYE_OPENAPI_OAUTH2_IMPLICIT_AUTHORIZATION_URL`	string
`quarkus.smallrye-openapi.oauth2-implicit-token-url` Add an implicit flow tokenUrl value to the OAuth2 Security Scheme Environment variable: `QUARKUS_SMALLRYE_OPENAPI_OAUTH2_IMPLICIT_TOKEN_URL`	string
`quarkus.smallrye-openapi.open-api-version` Override the openapi version in the Schema document Environment variable: `QUARKUS_SMALLRYE_OPENAPI_OPEN_API_VERSION`	string
`quarkus.smallrye-openapi.info-title` Set the title in Info tag in the Schema document Environment variable: `QUARKUS_SMALLRYE_OPENAPI_INFO_TITLE`	string
`quarkus.smallrye-openapi.info-version` Set the version in Info tag in the Schema document Environment variable: `QUARKUS_SMALLRYE_OPENAPI_INFO_VERSION`	string
`quarkus.smallrye-openapi.info-description` Set the description in Info tag in the Schema document Environment variable: `QUARKUS_SMALLRYE_OPENAPI_INFO_DESCRIPTION`	string
`quarkus.smallrye-openapi.info-terms-of-service` Set the terms of the service in Info tag in the Schema document Environment variable: `QUARKUS_SMALLRYE_OPENAPI_INFO_TERMS_OF_SERVICE`	string
`quarkus.smallrye-openapi.info-contact-email` Set the contact email in Info tag in the Schema document Environment variable: `QUARKUS_SMALLRYE_OPENAPI_INFO_CONTACT_EMAIL`	string
`quarkus.smallrye-openapi.info-contact-name` Set the contact name in Info tag in the Schema document Environment variable: `QUARKUS_SMALLRYE_OPENAPI_INFO_CONTACT_NAME`	string
`quarkus.smallrye-openapi.info-contact-url` Set the contact url in Info tag in the Schema document Environment variable: `QUARKUS_SMALLRYE_OPENAPI_INFO_CONTACT_URL`	string
`quarkus.smallrye-openapi.info-license-name` Set the license name in Info tag in the Schema document Environment variable: `QUARKUS_SMALLRYE_OPENAPI_INFO_LICENSE_NAME`	string
`quarkus.smallrye-openapi.info-license-url` Set the license url in Info tag in the Schema document Environment variable: `QUARKUS_SMALLRYE_OPENAPI_INFO_LICENSE_URL`	string
`quarkus.smallrye-openapi.operation-id-strategy` Set the strategy to automatically create an operation Id Environment variable: `QUARKUS_SMALLRYE_OPENAPI_OPERATION_ID_STRATEGY`	`method`, `class-method`, `package-class-method`
`quarkus.smallrye-openapi.enable` Enable the openapi endpoint. By default it’s enabled. Environment variable: `QUARKUS_SMALLRYE_OPENAPI_ENABLE`	boolean	`true`
`quarkus.smallrye-openapi.servers` Specify the list of global servers that provide connectivity information Environment variable: `QUARKUS_SMALLRYE_OPENAPI_SERVERS`	list of string
`quarkus.smallrye-openapi.security-scheme-extensions` Add one or more extensions to the security scheme Environment variable: `QUARKUS_SMALLRYE_OPENAPI_SECURITY_SCHEME_EXTENSIONS`	`Map<String,String>`

Configuration property

型

デフォルト

quarkus.smallrye-openapi.path

The path at which to register the OpenAPI Servlet.

Environment variable: QUARKUS_SMALLRYE_OPENAPI_PATH

string

openapi

quarkus.smallrye-openapi.store-schema-directory

If set, the generated OpenAPI schema documents will be stored here on build. Both openapi.json and openapi.yaml will be stored here if this is set.

Environment variable: QUARKUS_SMALLRYE_OPENAPI_STORE_SCHEMA_DIRECTORY

path

quarkus.smallrye-openapi.always-run-filter

Do not run the filter only at startup, but every time the document is requested (dynamic).

Environment variable: QUARKUS_SMALLRYE_OPENAPI_ALWAYS_RUN_FILTER

boolean

false

quarkus.smallrye-openapi.ignore-static-document

Do not include the provided static openapi document (eg. META-INF/openapi.yaml)

Environment variable: QUARKUS_SMALLRYE_OPENAPI_IGNORE_STATIC_DOCUMENT

boolean

false

quarkus.smallrye-openapi.additional-docs-directory

A list of local directories that should be scanned for yaml and/or json files to be included in the static model. Example: META-INF/openapi/

Environment variable: QUARKUS_SMALLRYE_OPENAPI_ADDITIONAL_DOCS_DIRECTORY

list of path

quarkus.smallrye-openapi.security-scheme

Environment variable: QUARKUS_SMALLRYE_OPENAPI_SECURITY_SCHEME

api-key, basic, jwt, oauth2, oidc, oauth2-implicit

quarkus.smallrye-openapi.security-scheme-name

Add a Security Scheme name to the generated OpenAPI document

Environment variable: QUARKUS_SMALLRYE_OPENAPI_SECURITY_SCHEME_NAME

string

SecurityScheme

quarkus.smallrye-openapi.security-scheme-description

Add a description to the Security Scheme

Environment variable: QUARKUS_SMALLRYE_OPENAPI_SECURITY_SCHEME_DESCRIPTION

string

Authentication

quarkus.smallrye-openapi.auto-add-security-requirement

This will automatically add the security requirement to all methods/classes that has a RolesAllowed annotation.

Environment variable: QUARKUS_SMALLRYE_OPENAPI_AUTO_ADD_SECURITY_REQUIREMENT

boolean

true

quarkus.smallrye-openapi.auto-add-tags

This will automatically add tags to operations based on the Java class name.

Environment variable: QUARKUS_SMALLRYE_OPENAPI_AUTO_ADD_TAGS

boolean

true

quarkus.smallrye-openapi.auto-add-server

Setting it to true will automatically add a default server to the schema if none is provided, using the current running server host and port.

Environment variable: QUARKUS_SMALLRYE_OPENAPI_AUTO_ADD_SERVER

boolean

quarkus.smallrye-openapi.auto-add-security

This will automatically add security based on the security extension included (if any).

Environment variable: QUARKUS_SMALLRYE_OPENAPI_AUTO_ADD_SECURITY

boolean

true

quarkus.smallrye-openapi.api-key-parameter-in

Required when using apiKey security. The location of the API key. Valid values are "query", "header" or "cookie".

Environment variable: QUARKUS_SMALLRYE_OPENAPI_API_KEY_PARAMETER_IN

string

quarkus.smallrye-openapi.api-key-parameter-name

Required when using apiKey security. The name of the header, query or cookie parameter to be used.

Environment variable: QUARKUS_SMALLRYE_OPENAPI_API_KEY_PARAMETER_NAME

string

quarkus.smallrye-openapi.basic-security-scheme-value

Add a scheme value to the Basic HTTP Security Scheme

Environment variable: QUARKUS_SMALLRYE_OPENAPI_BASIC_SECURITY_SCHEME_VALUE

string

basic

quarkus.smallrye-openapi.jwt-security-scheme-value

Add a scheme value to the JWT Security Scheme

Environment variable: QUARKUS_SMALLRYE_OPENAPI_JWT_SECURITY_SCHEME_VALUE

string

bearer

quarkus.smallrye-openapi.jwt-bearer-format

Add a bearer format the JWT Security Scheme

Environment variable: QUARKUS_SMALLRYE_OPENAPI_JWT_BEARER_FORMAT

string

JWT

quarkus.smallrye-openapi.oauth2-security-scheme-value

Add a scheme value to the OAuth2 opaque token Security Scheme

Environment variable: QUARKUS_SMALLRYE_OPENAPI_OAUTH2_SECURITY_SCHEME_VALUE

string

bearer

quarkus.smallrye-openapi.oauth2-bearer-format

Add a scheme value to OAuth2 opaque token Security Scheme

Environment variable: QUARKUS_SMALLRYE_OPENAPI_OAUTH2_BEARER_FORMAT

string

Opaque

quarkus.smallrye-openapi.oidc-open-id-connect-url

Add a openIdConnectUrl value to the OIDC Security Scheme

Environment variable: QUARKUS_SMALLRYE_OPENAPI_OIDC_OPEN_ID_CONNECT_URL

string

quarkus.smallrye-openapi.oauth2-implicit-refresh-url

Add a implicit flow refreshUrl value to the OAuth2 Security Scheme

Environment variable: QUARKUS_SMALLRYE_OPENAPI_OAUTH2_IMPLICIT_REFRESH_URL

string

quarkus.smallrye-openapi.oauth2-implicit-authorization-url

Add an implicit flow authorizationUrl value to the OAuth2 Security Scheme

Environment variable: QUARKUS_SMALLRYE_OPENAPI_OAUTH2_IMPLICIT_AUTHORIZATION_URL

string

quarkus.smallrye-openapi.oauth2-implicit-token-url

Add an implicit flow tokenUrl value to the OAuth2 Security Scheme

Environment variable: QUARKUS_SMALLRYE_OPENAPI_OAUTH2_IMPLICIT_TOKEN_URL

string

quarkus.smallrye-openapi.open-api-version

Override the openapi version in the Schema document

Environment variable: QUARKUS_SMALLRYE_OPENAPI_OPEN_API_VERSION

string

quarkus.smallrye-openapi.info-title

Set the title in Info tag in the Schema document

Environment variable: QUARKUS_SMALLRYE_OPENAPI_INFO_TITLE

string

quarkus.smallrye-openapi.info-version

Set the version in Info tag in the Schema document

Environment variable: QUARKUS_SMALLRYE_OPENAPI_INFO_VERSION

string

quarkus.smallrye-openapi.info-description

Set the description in Info tag in the Schema document

Environment variable: QUARKUS_SMALLRYE_OPENAPI_INFO_DESCRIPTION

string

quarkus.smallrye-openapi.info-terms-of-service

Set the terms of the service in Info tag in the Schema document

Environment variable: QUARKUS_SMALLRYE_OPENAPI_INFO_TERMS_OF_SERVICE

string

quarkus.smallrye-openapi.info-contact-email

Set the contact email in Info tag in the Schema document

Environment variable: QUARKUS_SMALLRYE_OPENAPI_INFO_CONTACT_EMAIL

string

quarkus.smallrye-openapi.info-contact-name

Set the contact name in Info tag in the Schema document

Environment variable: QUARKUS_SMALLRYE_OPENAPI_INFO_CONTACT_NAME

string

quarkus.smallrye-openapi.info-contact-url

Set the contact url in Info tag in the Schema document

Environment variable: QUARKUS_SMALLRYE_OPENAPI_INFO_CONTACT_URL

string

quarkus.smallrye-openapi.info-license-name

Set the license name in Info tag in the Schema document

Environment variable: QUARKUS_SMALLRYE_OPENAPI_INFO_LICENSE_NAME

string

quarkus.smallrye-openapi.info-license-url

Set the license url in Info tag in the Schema document

Environment variable: QUARKUS_SMALLRYE_OPENAPI_INFO_LICENSE_URL

string

quarkus.smallrye-openapi.operation-id-strategy

Set the strategy to automatically create an operation Id

Environment variable: QUARKUS_SMALLRYE_OPENAPI_OPERATION_ID_STRATEGY

method, class-method, package-class-method

quarkus.smallrye-openapi.enable

Enable the openapi endpoint. By default it’s enabled.

Environment variable: QUARKUS_SMALLRYE_OPENAPI_ENABLE

boolean

true

quarkus.smallrye-openapi.servers

Specify the list of global servers that provide connectivity information

Environment variable: QUARKUS_SMALLRYE_OPENAPI_SERVERS

list of string

quarkus.smallrye-openapi.security-scheme-extensions

Add one or more extensions to the security scheme

Environment variable: QUARKUS_SMALLRYE_OPENAPI_SECURITY_SCHEME_EXTENSIONS

Map<String,String>

Swagger UI

ビルド時に固定される設定プロパティ - その他の設定プロパティは実行時にオーバーライド可能です。

Configuration property	型	デフォルト
`quarkus.swagger-ui.path` The path where Swagger UI is available. The value `/` is not allowed as it blocks the application from serving anything else. By default, this value will be resolved as a path relative to `${quarkus.http.non-application-root-path}`. Environment variable: `QUARKUS_SWAGGER_UI_PATH`	string	`swagger-ui`
`quarkus.swagger-ui.always-include` If this should be included every time. By default, this is only included when the application is running in dev mode. Environment variable: `QUARKUS_SWAGGER_UI_ALWAYS_INCLUDE`	boolean	`false`
`quarkus.swagger-ui.urls-primary-name` If urls option is used, this will be the name of the default selection. Environment variable: `QUARKUS_SWAGGER_UI_URLS_PRIMARY_NAME`	string
`quarkus.swagger-ui.title` The html title for the page. Environment variable: `QUARKUS_SWAGGER_UI_TITLE`	string
`quarkus.swagger-ui.theme` Swagger UI theme to be used. Environment variable: `QUARKUS_SWAGGER_UI_THEME`	`original`, `feeling-blue`, `flattop`, `material`, `monokai`, `muted`, `newspaper`, `outline`
`quarkus.swagger-ui.footer` A footer for the html page. Nothing by default. Environment variable: `QUARKUS_SWAGGER_UI_FOOTER`	string
`quarkus.swagger-ui.deep-linking` If set to true, enables deep linking for tags and operations. Environment variable: `QUARKUS_SWAGGER_UI_DEEP_LINKING`	boolean
`quarkus.swagger-ui.display-operation-id` Controls the display of operationId in operations list. The default is false. Environment variable: `QUARKUS_SWAGGER_UI_DISPLAY_OPERATION_ID`	boolean
`quarkus.swagger-ui.default-models-expand-depth` The default expansion depth for models (set to -1 completely hide the models). Environment variable: `QUARKUS_SWAGGER_UI_DEFAULT_MODELS_EXPAND_DEPTH`	int
`quarkus.swagger-ui.default-model-expand-depth` The default expansion depth for the model on the model-example section. Environment variable: `QUARKUS_SWAGGER_UI_DEFAULT_MODEL_EXPAND_DEPTH`	int
`quarkus.swagger-ui.default-model-rendering` Controls how the model is shown when the API is first rendered. Environment variable: `QUARKUS_SWAGGER_UI_DEFAULT_MODEL_RENDERING`	string
`quarkus.swagger-ui.display-request-duration` Controls the display of the request duration (in milliseconds) for "Try it out" requests. Environment variable: `QUARKUS_SWAGGER_UI_DISPLAY_REQUEST_DURATION`	boolean
`quarkus.swagger-ui.doc-expansion` Controls the default expansion setting for the operations and tags. Environment variable: `QUARKUS_SWAGGER_UI_DOC_EXPANSION`	`list`, `full`, `none`
`quarkus.swagger-ui.filter` If set, enables filtering. The top bar will show an edit box that you can use to filter the tagged operations that are shown. Can be Boolean to enable or disable, or a string, in which case filtering will be enabled using that string as the filter expression. Filtering is case-sensitive matching the filter expression anywhere inside the tag. Environment variable: `QUARKUS_SWAGGER_UI_FILTER`	string
`quarkus.swagger-ui.max-displayed-tags` If set, limits the number of tagged operations displayed to at most this many. The default is to show all operations. Environment variable: `QUARKUS_SWAGGER_UI_MAX_DISPLAYED_TAGS`	int
`quarkus.swagger-ui.operations-sorter` Apply a sort to the operation list of each API. It can be 'alpha' (sort by paths alphanumerically), 'method' (sort by HTTP method) or a function (see Array.prototype.sort() to know how sort function works). Default is the order returned by the server unchanged. Environment variable: `QUARKUS_SWAGGER_UI_OPERATIONS_SORTER`	string
`quarkus.swagger-ui.show-extensions` Controls the display of vendor extension (x-) fields and values for Operations, Parameters, and Schema. Environment variable: `QUARKUS_SWAGGER_UI_SHOW_EXTENSIONS`	boolean
`quarkus.swagger-ui.show-common-extensions` Controls the display of extensions (pattern, maxLength, minLength, maximum, minimum) fields and values for Parameters. Environment variable: `QUARKUS_SWAGGER_UI_SHOW_COMMON_EXTENSIONS`	boolean
`quarkus.swagger-ui.tags-sorter` Apply a sort to the tag list of each API. It can be 'alpha' (sort by paths alphanumerically) or a function (see Array.prototype.sort() to learn how to write a sort function). Two tag name strings are passed to the sorter for each pass. Default is the order determined by Swagger UI. Environment variable: `QUARKUS_SWAGGER_UI_TAGS_SORTER`	string
`quarkus.swagger-ui.on-complete` Provides a mechanism to be notified when Swagger UI has finished rendering a newly provided definition. Environment variable: `QUARKUS_SWAGGER_UI_ON_COMPLETE`	string
`quarkus.swagger-ui.syntax-highlight` Set to `false` to deactivate syntax highlighting of payloads and cURL command. Can be otherwise an object with the `activate` and `theme` properties. Environment variable: `QUARKUS_SWAGGER_UI_SYNTAX_HIGHLIGHT`	string
`quarkus.swagger-ui.oauth2-redirect-url` OAuth redirect URL. Environment variable: `QUARKUS_SWAGGER_UI_OAUTH2_REDIRECT_URL`	string
`quarkus.swagger-ui.request-interceptor` MUST be a function. Function to intercept remote definition, "Try it out", and OAuth 2.0 requests. Accepts one argument requestInterceptor(request) and must return the modified request, or a Promise that resolves to the modified request. Environment variable: `QUARKUS_SWAGGER_UI_REQUEST_INTERCEPTOR`	string
`quarkus.swagger-ui.request-curl-options` If set, MUST be an array of command line options available to the curl command. This can be set on the mutated request in the requestInterceptor function. Environment variable: `QUARKUS_SWAGGER_UI_REQUEST_CURL_OPTIONS`	list of string
`quarkus.swagger-ui.response-interceptor` MUST be a function. Function to intercept remote definition, "Try it out", and OAuth 2.0 responses. Accepts one argument responseInterceptor(response) and must return the modified response, or a Promise that resolves to the modified response. Environment variable: `QUARKUS_SWAGGER_UI_RESPONSE_INTERCEPTOR`	string
`quarkus.swagger-ui.show-mutated-request` If set to true, uses the mutated request returned from a requestInterceptor to produce the curl command in the UI, otherwise the request before the requestInterceptor was applied is used. Environment variable: `QUARKUS_SWAGGER_UI_SHOW_MUTATED_REQUEST`	boolean
`quarkus.swagger-ui.supported-submit-methods` List of HTTP methods that have the "Try it out" feature enabled. An empty array disables "Try it out" for all operations. This does not filter the operations from the display. Environment variable: `QUARKUS_SWAGGER_UI_SUPPORTED_SUBMIT_METHODS`	list of HttpMethod
`quarkus.swagger-ui.validator-url` By default, Swagger UI attempts to validate specs against swagger.io’s online validator. You can use this parameter to set a different validator URL, for example for locally deployed validators (Validator Badge). Setting it to either none, 127.0.0.1 or localhost will disable validation. Environment variable: `QUARKUS_SWAGGER_UI_VALIDATOR_URL`	string
`quarkus.swagger-ui.with-credentials` If set to true, enables passing credentials, as defined in the Fetch standard, in CORS requests that are sent by the browser. Environment variable: `QUARKUS_SWAGGER_UI_WITH_CREDENTIALS`	boolean
`quarkus.swagger-ui.model-property-macro` Function to set default values to each property in model. Accepts one argument modelPropertyMacro(property), property is immutable Environment variable: `QUARKUS_SWAGGER_UI_MODEL_PROPERTY_MACRO`	string
`quarkus.swagger-ui.parameter-macro` Function to set default value to parameters. Accepts two arguments parameterMacro(operation, parameter). Operation and parameter are objects passed for context, both remain immutable Environment variable: `QUARKUS_SWAGGER_UI_PARAMETER_MACRO`	string
`quarkus.swagger-ui.persist-authorization` If set to true, it persists authorization data and it would not be lost on browser close/refresh Environment variable: `QUARKUS_SWAGGER_UI_PERSIST_AUTHORIZATION`	boolean
`quarkus.swagger-ui.layout` The name of a component available via the plugin system to use as the top-level layout for Swagger UI. Environment variable: `QUARKUS_SWAGGER_UI_LAYOUT`	string
`quarkus.swagger-ui.plugins` A list of plugin functions to use in Swagger UI. Environment variable: `QUARKUS_SWAGGER_UI_PLUGINS`	list of string
`quarkus.swagger-ui.presets` A list of presets to use in Swagger UI. Environment variable: `QUARKUS_SWAGGER_UI_PRESETS`	list of string
`quarkus.swagger-ui.oauth-client-id` OAuth default clientId - Used in the initOAuth method. Environment variable: `QUARKUS_SWAGGER_UI_OAUTH_CLIENT_ID`	string
`quarkus.swagger-ui.oauth-client-secret` OAuth default clientSecret - Used in the initOAuth method. Environment variable: `QUARKUS_SWAGGER_UI_OAUTH_CLIENT_SECRET`	string
`quarkus.swagger-ui.oauth-realm` OAuth1 Realm query parameter added to authorizationUrl and tokenUrl - Used in the initOAuth method. Environment variable: `QUARKUS_SWAGGER_UI_OAUTH_REALM`	string
`quarkus.swagger-ui.oauth-app-name` OAuth application name, displayed in authorization popup - Used in the initOAuth method. Environment variable: `QUARKUS_SWAGGER_UI_OAUTH_APP_NAME`	string
`quarkus.swagger-ui.oauth-scope-separator` OAuth scope separator for passing scopes - Used in the initOAuth method. Environment variable: `QUARKUS_SWAGGER_UI_OAUTH_SCOPE_SEPARATOR`	string
`quarkus.swagger-ui.oauth-scopes` OAuth Scopes, separated using the oauthScopeSeparator - Used in the initOAuth method. Environment variable: `QUARKUS_SWAGGER_UI_OAUTH_SCOPES`	string
`quarkus.swagger-ui.oauth-additional-query-string-params` OAuth additional query parameters added to authorizationUrl and tokenUrl - Used in the initOAuth method. Environment variable: `QUARKUS_SWAGGER_UI_OAUTH_ADDITIONAL_QUERY_STRING_PARAMS`	string
`quarkus.swagger-ui.oauth-use-basic-authentication-with-access-code-grant` OAuth only activated for the accessCode flow. During the authorization_code request to the tokenUrl, pass the Client Password using the HTTP Basic Authentication scheme - Used in the initOAuth method. Environment variable: `QUARKUS_SWAGGER_UI_OAUTH_USE_BASIC_AUTHENTICATION_WITH_ACCESS_CODE_GRANT`	boolean
`quarkus.swagger-ui.oauth-use-pkce-with-authorization-code-grant` OAuth only applies to authorization code flows. Proof Key for Code Exchange brings enhanced security for OAuth public clients - Used in the initOAuth method. Environment variable: `QUARKUS_SWAGGER_UI_OAUTH_USE_PKCE_WITH_AUTHORIZATION_CODE_GRANT`	boolean
`quarkus.swagger-ui.preauthorize-basic-auth-definition-key` Pre-authorize Basic Auth, programmatically set DefinitionKey for a Basic authorization scheme - Used in the preauthorizeBasic method. Environment variable: `QUARKUS_SWAGGER_UI_PREAUTHORIZE_BASIC_AUTH_DEFINITION_KEY`	string
`quarkus.swagger-ui.preauthorize-basic-username` Pre-authorize Basic Auth, programmatically set Username for a Basic authorization scheme - Used in the preauthorizeBasic method. Environment variable: `QUARKUS_SWAGGER_UI_PREAUTHORIZE_BASIC_USERNAME`	string
`quarkus.swagger-ui.preauthorize-basic-password` Pre-authorize Basic Auth, programmatically set Password for a Basic authorization scheme - Used in the preauthorizeBasic method. Environment variable: `QUARKUS_SWAGGER_UI_PREAUTHORIZE_BASIC_PASSWORD`	string
`quarkus.swagger-ui.preauthorize-api-key-auth-definition-key` Pre-authorize ApiKey Auth, programmatically set DefinitionKey for an API key or Bearer authorization scheme - Used in the preauthorizeApiKey method. Environment variable: `QUARKUS_SWAGGER_UI_PREAUTHORIZE_API_KEY_AUTH_DEFINITION_KEY`	string
`quarkus.swagger-ui.preauthorize-api-key-api-key-value` Pre-authorize ApiKey Auth, programmatically set ApiKeyValue for an API key or Bearer authorization scheme - Used in the preauthorizeApiKey method. Environment variable: `QUARKUS_SWAGGER_UI_PREAUTHORIZE_API_KEY_API_KEY_VALUE`	string
`quarkus.swagger-ui.query-config-enabled` If set to true, this allows the user to modify and test different query parameters in the API request Environment variable: `QUARKUS_SWAGGER_UI_QUERY_CONFIG_ENABLED`	boolean	`false`
`quarkus.swagger-ui.enable` If Swagger UI is included, it should be enabled/disabled. By default, Swagger UI is enabled if it is included (see `always-include`). Environment variable: `QUARKUS_SWAGGER_UI_ENABLE`	boolean	`true`
`quarkus.swagger-ui.urls` The urls that will be included as options. By default, the OpenAPI path will be used. Here you can override that and supply multiple urls that will appear in the TopBar plugin. Environment variable: `QUARKUS_SWAGGER_UI_URLS`	`Map<String,String>`

Configuration property

型

デフォルト

quarkus.swagger-ui.path

The path where Swagger UI is available. The value / is not allowed as it blocks the application from serving anything else. By default, this value will be resolved as a path relative to ${quarkus.http.non-application-root-path}.

Environment variable: QUARKUS_SWAGGER_UI_PATH

string

swagger-ui

quarkus.swagger-ui.always-include

If this should be included every time. By default, this is only included when the application is running in dev mode.

Environment variable: QUARKUS_SWAGGER_UI_ALWAYS_INCLUDE

boolean

false

quarkus.swagger-ui.urls-primary-name

If urls option is used, this will be the name of the default selection.

Environment variable: QUARKUS_SWAGGER_UI_URLS_PRIMARY_NAME

string

quarkus.swagger-ui.title

The html title for the page.

Environment variable: QUARKUS_SWAGGER_UI_TITLE

string

quarkus.swagger-ui.theme

Swagger UI theme to be used.

Environment variable: QUARKUS_SWAGGER_UI_THEME

original, feeling-blue, flattop, material, monokai, muted, newspaper, outline

quarkus.swagger-ui.footer

A footer for the html page. Nothing by default.

Environment variable: QUARKUS_SWAGGER_UI_FOOTER

string

quarkus.swagger-ui.deep-linking

If set to true, enables deep linking for tags and operations.

Environment variable: QUARKUS_SWAGGER_UI_DEEP_LINKING

boolean

quarkus.swagger-ui.display-operation-id

Controls the display of operationId in operations list. The default is false.

Environment variable: QUARKUS_SWAGGER_UI_DISPLAY_OPERATION_ID

boolean

quarkus.swagger-ui.default-models-expand-depth

The default expansion depth for models (set to -1 completely hide the models).

Environment variable: QUARKUS_SWAGGER_UI_DEFAULT_MODELS_EXPAND_DEPTH

int

quarkus.swagger-ui.default-model-expand-depth

The default expansion depth for the model on the model-example section.

Environment variable: QUARKUS_SWAGGER_UI_DEFAULT_MODEL_EXPAND_DEPTH

int

quarkus.swagger-ui.default-model-rendering

Controls how the model is shown when the API is first rendered.

Environment variable: QUARKUS_SWAGGER_UI_DEFAULT_MODEL_RENDERING

string

quarkus.swagger-ui.display-request-duration

Controls the display of the request duration (in milliseconds) for "Try it out" requests.

Environment variable: QUARKUS_SWAGGER_UI_DISPLAY_REQUEST_DURATION

boolean

quarkus.swagger-ui.doc-expansion

Controls the default expansion setting for the operations and tags.

Environment variable: QUARKUS_SWAGGER_UI_DOC_EXPANSION

list, full, none

quarkus.swagger-ui.filter

If set, enables filtering. The top bar will show an edit box that you can use to filter the tagged operations that are shown. Can be Boolean to enable or disable, or a string, in which case filtering will be enabled using that string as the filter expression. Filtering is case-sensitive matching the filter expression anywhere inside the tag.

Environment variable: QUARKUS_SWAGGER_UI_FILTER

string

quarkus.swagger-ui.max-displayed-tags

If set, limits the number of tagged operations displayed to at most this many. The default is to show all operations.

Environment variable: QUARKUS_SWAGGER_UI_MAX_DISPLAYED_TAGS

int

quarkus.swagger-ui.operations-sorter

Apply a sort to the operation list of each API. It can be 'alpha' (sort by paths alphanumerically), 'method' (sort by HTTP method) or a function (see Array.prototype.sort() to know how sort function works). Default is the order returned by the server unchanged.

Environment variable: QUARKUS_SWAGGER_UI_OPERATIONS_SORTER

string

quarkus.swagger-ui.show-extensions

Controls the display of vendor extension (x-) fields and values for Operations, Parameters, and Schema.

Environment variable: QUARKUS_SWAGGER_UI_SHOW_EXTENSIONS

boolean

quarkus.swagger-ui.show-common-extensions

Controls the display of extensions (pattern, maxLength, minLength, maximum, minimum) fields and values for Parameters.

Environment variable: QUARKUS_SWAGGER_UI_SHOW_COMMON_EXTENSIONS

boolean

quarkus.swagger-ui.tags-sorter

Apply a sort to the tag list of each API. It can be 'alpha' (sort by paths alphanumerically) or a function (see Array.prototype.sort() to learn how to write a sort function). Two tag name strings are passed to the sorter for each pass. Default is the order determined by Swagger UI.

Environment variable: QUARKUS_SWAGGER_UI_TAGS_SORTER

string

quarkus.swagger-ui.on-complete

Provides a mechanism to be notified when Swagger UI has finished rendering a newly provided definition.

Environment variable: QUARKUS_SWAGGER_UI_ON_COMPLETE

string

quarkus.swagger-ui.syntax-highlight

Set to false to deactivate syntax highlighting of payloads and cURL command. Can be otherwise an object with the activate and theme properties.

Environment variable: QUARKUS_SWAGGER_UI_SYNTAX_HIGHLIGHT

string

quarkus.swagger-ui.oauth2-redirect-url

OAuth redirect URL.

Environment variable: QUARKUS_SWAGGER_UI_OAUTH2_REDIRECT_URL

string

quarkus.swagger-ui.request-interceptor

MUST be a function. Function to intercept remote definition, "Try it out", and OAuth 2.0 requests. Accepts one argument requestInterceptor(request) and must return the modified request, or a Promise that resolves to the modified request.

Environment variable: QUARKUS_SWAGGER_UI_REQUEST_INTERCEPTOR

string

quarkus.swagger-ui.request-curl-options

If set, MUST be an array of command line options available to the curl command. This can be set on the mutated request in the requestInterceptor function.

Environment variable: QUARKUS_SWAGGER_UI_REQUEST_CURL_OPTIONS

list of string

quarkus.swagger-ui.response-interceptor

MUST be a function. Function to intercept remote definition, "Try it out", and OAuth 2.0 responses. Accepts one argument responseInterceptor(response) and must return the modified response, or a Promise that resolves to the modified response.

Environment variable: QUARKUS_SWAGGER_UI_RESPONSE_INTERCEPTOR

string

quarkus.swagger-ui.show-mutated-request

If set to true, uses the mutated request returned from a requestInterceptor to produce the curl command in the UI, otherwise the request before the requestInterceptor was applied is used.

Environment variable: QUARKUS_SWAGGER_UI_SHOW_MUTATED_REQUEST

boolean

quarkus.swagger-ui.supported-submit-methods

List of HTTP methods that have the "Try it out" feature enabled. An empty array disables "Try it out" for all operations. This does not filter the operations from the display.

Environment variable: QUARKUS_SWAGGER_UI_SUPPORTED_SUBMIT_METHODS

list of HttpMethod

quarkus.swagger-ui.validator-url

By default, Swagger UI attempts to validate specs against swagger.io’s online validator. You can use this parameter to set a different validator URL, for example for locally deployed validators (Validator Badge). Setting it to either none, 127.0.0.1 or localhost will disable validation.

Environment variable: QUARKUS_SWAGGER_UI_VALIDATOR_URL

string

quarkus.swagger-ui.with-credentials

If set to true, enables passing credentials, as defined in the Fetch standard, in CORS requests that are sent by the browser.

Environment variable: QUARKUS_SWAGGER_UI_WITH_CREDENTIALS

boolean

quarkus.swagger-ui.model-property-macro

Function to set default values to each property in model. Accepts one argument modelPropertyMacro(property), property is immutable

Environment variable: QUARKUS_SWAGGER_UI_MODEL_PROPERTY_MACRO

string

quarkus.swagger-ui.parameter-macro

Function to set default value to parameters. Accepts two arguments parameterMacro(operation, parameter). Operation and parameter are objects passed for context, both remain immutable

Environment variable: QUARKUS_SWAGGER_UI_PARAMETER_MACRO

string

quarkus.swagger-ui.persist-authorization

If set to true, it persists authorization data and it would not be lost on browser close/refresh

Environment variable: QUARKUS_SWAGGER_UI_PERSIST_AUTHORIZATION

boolean

quarkus.swagger-ui.layout

The name of a component available via the plugin system to use as the top-level layout for Swagger UI.

Environment variable: QUARKUS_SWAGGER_UI_LAYOUT

string

quarkus.swagger-ui.plugins

A list of plugin functions to use in Swagger UI.

Environment variable: QUARKUS_SWAGGER_UI_PLUGINS

list of string

quarkus.swagger-ui.presets

A list of presets to use in Swagger UI.

Environment variable: QUARKUS_SWAGGER_UI_PRESETS

list of string

quarkus.swagger-ui.oauth-client-id

OAuth default clientId - Used in the initOAuth method.

Environment variable: QUARKUS_SWAGGER_UI_OAUTH_CLIENT_ID

string

quarkus.swagger-ui.oauth-client-secret

OAuth default clientSecret - Used in the initOAuth method.

Environment variable: QUARKUS_SWAGGER_UI_OAUTH_CLIENT_SECRET

string

quarkus.swagger-ui.oauth-realm

OAuth1 Realm query parameter added to authorizationUrl and tokenUrl - Used in the initOAuth method.

Environment variable: QUARKUS_SWAGGER_UI_OAUTH_REALM

string

quarkus.swagger-ui.oauth-app-name

OAuth application name, displayed in authorization popup - Used in the initOAuth method.

Environment variable: QUARKUS_SWAGGER_UI_OAUTH_APP_NAME

string

quarkus.swagger-ui.oauth-scope-separator

OAuth scope separator for passing scopes - Used in the initOAuth method.

Environment variable: QUARKUS_SWAGGER_UI_OAUTH_SCOPE_SEPARATOR

string

quarkus.swagger-ui.oauth-scopes

OAuth Scopes, separated using the oauthScopeSeparator - Used in the initOAuth method.

Environment variable: QUARKUS_SWAGGER_UI_OAUTH_SCOPES

string

quarkus.swagger-ui.oauth-additional-query-string-params

OAuth additional query parameters added to authorizationUrl and tokenUrl - Used in the initOAuth method.

Environment variable: QUARKUS_SWAGGER_UI_OAUTH_ADDITIONAL_QUERY_STRING_PARAMS

string

quarkus.swagger-ui.oauth-use-basic-authentication-with-access-code-grant

OAuth only activated for the accessCode flow. During the authorization_code request to the tokenUrl, pass the Client Password using the HTTP Basic Authentication scheme - Used in the initOAuth method.

Environment variable: QUARKUS_SWAGGER_UI_OAUTH_USE_BASIC_AUTHENTICATION_WITH_ACCESS_CODE_GRANT

boolean

quarkus.swagger-ui.oauth-use-pkce-with-authorization-code-grant

OAuth only applies to authorization code flows. Proof Key for Code Exchange brings enhanced security for OAuth public clients - Used in the initOAuth method.

Environment variable: QUARKUS_SWAGGER_UI_OAUTH_USE_PKCE_WITH_AUTHORIZATION_CODE_GRANT

boolean

quarkus.swagger-ui.preauthorize-basic-auth-definition-key

Pre-authorize Basic Auth, programmatically set DefinitionKey for a Basic authorization scheme - Used in the preauthorizeBasic method.

Environment variable: QUARKUS_SWAGGER_UI_PREAUTHORIZE_BASIC_AUTH_DEFINITION_KEY

string

quarkus.swagger-ui.preauthorize-basic-username

Pre-authorize Basic Auth, programmatically set Username for a Basic authorization scheme - Used in the preauthorizeBasic method.

Environment variable: QUARKUS_SWAGGER_UI_PREAUTHORIZE_BASIC_USERNAME

string

quarkus.swagger-ui.preauthorize-basic-password

Pre-authorize Basic Auth, programmatically set Password for a Basic authorization scheme - Used in the preauthorizeBasic method.

Environment variable: QUARKUS_SWAGGER_UI_PREAUTHORIZE_BASIC_PASSWORD

string

quarkus.swagger-ui.preauthorize-api-key-auth-definition-key

Pre-authorize ApiKey Auth, programmatically set DefinitionKey for an API key or Bearer authorization scheme - Used in the preauthorizeApiKey method.

Environment variable: QUARKUS_SWAGGER_UI_PREAUTHORIZE_API_KEY_AUTH_DEFINITION_KEY

string

quarkus.swagger-ui.preauthorize-api-key-api-key-value

Pre-authorize ApiKey Auth, programmatically set ApiKeyValue for an API key or Bearer authorization scheme - Used in the preauthorizeApiKey method.

Environment variable: QUARKUS_SWAGGER_UI_PREAUTHORIZE_API_KEY_API_KEY_VALUE

string

quarkus.swagger-ui.query-config-enabled

If set to true, this allows the user to modify and test different query parameters in the API request

Environment variable: QUARKUS_SWAGGER_UI_QUERY_CONFIG_ENABLED

boolean

false

quarkus.swagger-ui.enable

If Swagger UI is included, it should be enabled/disabled. By default, Swagger UI is enabled if it is included (see always-include).

Environment variable: QUARKUS_SWAGGER_UI_ENABLE

boolean

true

quarkus.swagger-ui.urls

The urls that will be included as options. By default, the OpenAPI path will be used. Here you can override that and supply multiple urls that will appear in the TopBar plugin.

Environment variable: QUARKUS_SWAGGER_UI_URLS

Map<String,String>