io.swagger.v3.oas.annotations.info

Annotation Type Info

@Target(value=ANNOTATION_TYPE)
 @Retention(value=RUNTIME)
 @Inherited
public @interface Info

The annotation may be used in OpenAPIDefinition.info() to populate the Info section of the OpenAPI document.

See Also:

Info (OpenAPI specification), OpenAPIDefinition

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
Contact	contact The contact information for the exposed API.
String	description A short description of the application.
Extension[]	extensions The list of optional extensions
License	license The license information for the exposed API.
String	termsOfService A URL to the Terms of Service for the API.
String	title The title of the application.
String	version The version of the API definition.

Element Detail

title

public abstract String title

The title of the application.

Returns:

the application's title

Default:

""

description

public abstract String description

A short description of the application. CommonMark syntax can be used for rich text representation.

Returns:

the application's description

Default:

""

termsOfService

public abstract String termsOfService

A URL to the Terms of Service for the API. Must be in the format of a URL.

Returns:

the application's terms of service

Default:

""

contact

public abstract Contact contact

The contact information for the exposed API.

Returns:

a contact for the application

Default:

@io.swagger.v3.oas.annotations.info.Contact

license

public abstract License license

The license information for the exposed API.

Returns:

the license of the application

Default:

@io.swagger.v3.oas.annotations.info.License

version

public abstract String version

The version of the API definition.

Returns:

the application's version

Default:

""

extensions

public abstract Extension[] extensions

The list of optional extensions

Returns:

an optional array of extensions

Default:

{}