FormatsController.php

<?php

namespace Bmlt\SemanticOpenApi\Swagger;

use OpenApi\Attributes as OA;

class FormatsController extends Controller
{
    #[OA\Get(
        path: '/client_interface/json/?switcher=GetFormats',
        operationId: 'getFormats',
        summary: 'Get meeting formats',
        tags: ['Formats'],
        parameters: [
            new OA\Parameter(name: 'switcher', in: 'query', required: true, schema: new OA\Schema(type: 'string', enum: ['GetFormats'])),
            new OA\Parameter(ref: '#/components/parameters/LangEnum'),
            new OA\Parameter(ref: '#/components/parameters/ShowAll'),
            new OA\Parameter(name: 'format_ids', in: 'query', description: 'Format IDs to include (positive) or exclude (negative). Comma-separated.', schema: new OA\Schema(type: 'string', example: '1,2,-3')),
            new OA\Parameter(name: 'key_strings', in: 'query', description: 'Format key strings to filter by. Comma-separated.', schema: new OA\Schema(type: 'string', example: 'O,C')),
        ],
        responses: [
            new OA\Response(
                response: 200,
                description: 'List of formats',
                content: new OA\JsonContent(type: 'array', items: new OA\Items(ref: '#/components/schemas/Format'))
            ),
        ]
    )]
    public function getFormats()
    {
    }
}