Interface IOperation

API operation metadata.

interface IOperation {
    deprecated?: boolean;
    description?: string;
    operationId?: string;
    parameters?: (
        | SwaggerV2.IOperation.IParameter
        | SwaggerV2.IJsonSchema.IReference<`#/definitions/parameters/${string}`>
    )[];
    responses?: Record<
        string,
        | SwaggerV2.IOperation.IResponse
        | SwaggerV2.IJsonSchema.IReference<`#/definitions/responses/${string}`>,
    >;
    security?: Record<string, string[]>[];
    summary?: string;
    tags?: string[];
}

Index

Properties

deprecated? description? operationId? parameters? responses? security? summary? tags?

Properties

`Optional`deprecated

deprecated?: boolean

Whether deprecated.

`Optional`description

description?: string

Full description.

`Optional`operationId

operationId?: string

Unique operation identifier.

`Optional`parameters

parameters?: (
| SwaggerV2.IOperation.IParameter
| SwaggerV2.IJsonSchema.IReference<`#/definitions/parameters/${string}`>
)[]

Operation parameters.

`Optional`responses

responses?: Record<
    string,
    | SwaggerV2.IOperation.IResponse
    | SwaggerV2.IJsonSchema.IReference<`#/definitions/responses/${string}`>,
>

Response definitions by status code.

`Optional`security

security?: Record<string, string[]>[]

Security requirements.

`Optional`summary

summary?: string

Short summary.

`Optional`tags

tags?: string[]

Operation tags.