tegral-openapi-ktor/guru.zoroark.tegral.openapi.ktor

Package guru.zoroark.tegral.openapi.ktor

Types

EndpointDescriptionHook

typealias EndpointDescriptionHook = OperationDsl.() -> Unit

TegralOpenApiKtor

class TegralOpenApiKtor

A Ktor plugin that adds a Tegral OpenAPI DSL integration to the Ktor application, including:

Functions

describe

fun Application.describe(description: RootDsl.() -> Unit)

Specify additional information about the API via the RootDsl.

infix fun Route.describe(description: OperationDsl.() -> Unit): Route

Adds an OpenAPI operation description to this route.

describeSubroutes

fun Route.describeSubroutes(hook: OperationDsl.() -> Unit)

Adds a hook to the given route. All following descriptions on endpoints that are sub-endpoints of this route will have the given hook applied to their description.

openApiEndpoint

fun Route.openApiEndpoint(path: String): Route

Adds a get(path) endpoint that will return the OpenAPI document for this API.

Properties

openApi

val Application.openApi: TegralOpenApiKtor

Retrieve the TegralOpenApiKtor plugin from this application.