Annotation Interface OpenAPIDefinition
OpenAPI
This is the root document object of the OpenAPI document. It contains required and optional fields.
- See Also:
-
Required Element Summary
-
Optional Element Summary
Modifier and TypeOptional ElementDescriptionAn element to hold a set of reusable objects for different aspects of the OpenAPI Specification (OAS).Any additional external documentation for the APIA declaration of which security mechanisms can be used across the API.Server[]
An array of Server Objects, which provide connectivity information to a target server.Tag[]
A list of tags used by the specification with additional metadata.
-
Element Details
-
info
Info infoRequired: Provides metadata about the API. The metadata MAY be used by tooling as required.- Returns:
- the metadata about this API
-
-
-
tags
Tag[] tagsA list of tags used by the specification with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools.- Returns:
- the tags used by the specification with any additional metadata
- Default:
- {}
-
servers
Server[] serversAn array of Server Objects, which provide connectivity information to a target server. If the servers property is not provided, or is an empty array, the default value would be a Server Object with a url value of /.- Returns:
- the servers of this API
- Default:
- {}
-
security
SecurityRequirement[] securityA declaration of which security mechanisms can be used across the API.- Returns:
- the array of servers used for this API
- Default:
- {}
-
externalDocs
ExternalDocumentation externalDocsAny additional external documentation for the API- Returns:
- the external documentation for this API.
- Default:
- @org.eclipse.microprofile.openapi.annotations.ExternalDocumentation
-
components
Components componentsAn element to hold a set of reusable objects for different aspects of the OpenAPI Specification (OAS). All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.- Returns:
- the element with a set of reusable objects for different aspects of the OAS.
- Default:
- @org.eclipse.microprofile.openapi.annotations.Components
-