tegral-openapi-dsl/guru.zoroark.tegral.openapi.dsl/OperationDsl

OperationDsl

interface OperationDsl

DSL for the operation object.

Note that the externalDocs object is embedded in this DSL.

Functions

body

abstract fun body(builder: RequestBodyDsl.() -> Unit)

Defines the request body for this operation.

cookieParameter

abstract infix fun String.cookieParameter(builder: ParameterDsl.() -> Unit)

Creates a cookie parameter, with the given string as the name of the cookie.

headerParameter

abstract infix fun String.headerParameter(builder: ParameterDsl.() -> Unit)

Creates a header parameter, with the given string as the name of the header.

pathParameter

abstract infix fun String.pathParameter(builder: ParameterDsl.() -> Unit)

Creates a path parameter, with the given string as the name of the corresponding path segment.

queryParameter

abstract infix fun String.queryParameter(builder: ParameterDsl.() -> Unit)

Creates a query parameter, with the given string as the name of the query parameter key.

response

abstract infix fun Int.response(builder: ResponseDsl.() -> Unit)

Creates a response for the given response code (passed as an integer value).

security

abstract fun security(key: String)

Adds a security requirement object to this operation with the given key.

abstract fun security(key: String, vararg scopes: String)

Adds a security requirement object to this operation with the given key and scopes.

Properties

deprecated

abstract var deprecated: Boolean?

If true, declares this operation to be deprecated (false by default).

description

abstract var description: String?

A verbose explanation of the operation behavior. CommonMark syntax may be used for rich text representation.

externalDocsDescription

abstract var externalDocsDescription: String?

A description of the additional external documentation for this operation. CommonMark syntax may be used for rich text representation.

externalDocsUrl

abstract var externalDocsUrl: String?

A URL that points to additional external documentation for this operation. Must be a valid URL.

operationId

abstract var operationId: String?

A string used to identify the operation, unique among all operations described in the API.

parameters

abstract val parameters: MutableList<Buildable<Parameter>>

Parameters that are applicable for this operation.

requestBody

abstract var requestBody: RequestBodyBuilder?

The request body applicable for this operation.

responses

abstract val responses: MutableMap<Int, Buildable<ApiResponse>>

The list of possible responses as they are returned from executing this operation.

securityRequirements

abstract val securityRequirements: MutableList<SecurityRequirement>

A declaration of which security mechanisms can be used for this operation.

summary

abstract var summary: String?

A short summary of what the operation does.

Inheritors

OperationBuilder