Package-level declarations

Types

Link copied to clipboard

The locations of the API key.

Link copied to clipboard

The authentication scheme. https://www.iana.org/assignments/http-authschemes/http-authschemes.xhtml

Link copied to clipboard

The type of security schemes

Link copied to clipboard
sealed class BaseBodyConfig

Describes a single request/response body with a single schema.

Link copied to clipboard

Contact information for the exposed API.

Link copied to clipboard

Configuration for examples

Link copied to clipboard
Link copied to clipboard

An object representing external documentation.

Link copied to clipboard
typealias GenericExampleEncoder = (type: TypeDescriptor?, example: Any?) -> Any?

Encoder to produce the final example value. Return the unmodified example to fall back to the default encoder.

Link copied to clipboard
typealias GenericSchemaGenerator = (type: InitialTypeData) -> CompiledSwaggerSchemaData

Function to generate swagger schemas for any given type

Link copied to clipboard

Describes a single header.

Link copied to clipboard

Basic information for the exposed API.

Link copied to clipboard

License information for the exposed API.

Link copied to clipboard

Describes a single request/response body with multipart content. See https://swagger.io/docs/specification/describing-request-body/multipart-requests/ for more info

Link copied to clipboard

Describes one section of a multipart-body. See https://swagger.io/docs/specification/describing-request-body/multipart-requests/ for more info

Link copied to clipboard
annotation class OpenApiDslMarker
Link copied to clipboard

Main-Configuration of the "OpenApi"-Plugin

Link copied to clipboard

Configuration details for a supported OAuth Flow

Link copied to clipboard

An object containing configuration information for the oauth flow types supported

Link copied to clipboard
Link copied to clipboard

Locations for request parameters.

Link copied to clipboard
typealias PathFilter = (method: HttpMethod, url: List<String>) -> Boolean

Filters paths to determine which to include (return 'true') in the spec and which to hide (return 'true').

Link copied to clipboard
typealias PostBuild = (openApi: OpenAPI, specName: String) -> Unit

Function executed after building the openapi-spec.

Link copied to clipboard

Describes a single request.

Link copied to clipboard

Describes a single request parameter.

Link copied to clipboard

A container for the expected responses of an operation. The container maps an HTTP response code to the expected response. A response code can only have one response object.

Link copied to clipboard

All possible responses of an operation

Link copied to clipboard

Describes a single route including request and responses.

Link copied to clipboard

Configuration for schemas

Link copied to clipboard
Link copied to clipboard
open class SchemaOverwriteModule(val identifier: String, val schema: () -> Schema<*>) : ReflectionTypeAnalyzerModule, SerializationTypeAnalyzerModule, SwaggerSchemaGenerationModule

Overwrite specific types with custom schemas

Link copied to clipboard

Configuration for security and authentication.

Link copied to clipboard

Defines a security scheme that can be used by the operations. Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), OAuth2's common flows (implicit, password, client credentials and authorization code)

Link copied to clipboard

An object representing a Server.

Link copied to clipboard

An object representing a Server Variable for server URL template substitution.

Link copied to clipboard

Describes the base of a single request/response body.

Link copied to clipboard
typealias SpecAssigner = (url: String, tags: List<String>) -> String

Assigns (unassigned) routes to api-specs. url - the parts of the route-url split at all /. tags - the tags assigned to the route

Link copied to clipboard
class TagConfig

Adds metadata to a single tag.

Link copied to clipboard
typealias TagGenerator = (url: List<String>) -> Collection<String?>

Generates additional tags for routes. url - the parts of the route-url split at all /. return a collection of tags. "Null"-entries will be ignored.

Link copied to clipboard

Configuration for tags