ServerController.php

<?php

namespace Bmlt\SemanticOpenApi\Swagger;

use OpenApi\Attributes as OA;

class ServerController extends Controller
{
    #[OA\Get(
        path: '/client_interface/json/?switcher=GetServerInfo',
        operationId: 'getServerInfo',
        summary: 'Get server information',
        tags: ['Server'],
        parameters: [
            new OA\Parameter(name: 'switcher', in: 'query', required: true, schema: new OA\Schema(type: 'string', enum: ['GetServerInfo'])),
        ],
        responses: [
            new OA\Response(
                response: 200,
                description: "Server metadata such as version, language, semantic admin URL, etc.",
                content: new OA\JsonContent(type: 'array', items: new OA\Items(ref: '#/components/schemas/ServerInfo'))
            ),
        ]
    )]
    public function getServerInfo()
    {
    }

    #[OA\Get(
        path: '/client_interface/json/?switcher=GetCoverageArea',
        operationId: 'getCoverageArea',
        summary: "Get the geographic coverage bounding box for this server",
        tags: ['Server'],
        parameters: [
            new OA\Parameter(name: 'switcher', in: 'query', required: true, schema: new OA\Schema(type: 'string', enum: ['GetCoverageArea'])),
        ],
        responses: [
            new OA\Response(
                response: 200,
                description: "Bounding box for the area covered by this server's meetings",
                content: new OA\JsonContent(
                    type: 'object',
                    properties: [
                        new OA\Property(property: 'nw_corner_longitude', type: 'number', format: 'float'),
                        new OA\Property(property: 'nw_corner_latitude', type: 'number', format: 'float'),
                        new OA\Property(property: 'se_corner_longitude', type: 'number', format: 'float'),
                        new OA\Property(property: 'se_corner_latitude', type: 'number', format: 'float'),
                    ]
                )
            ),
        ]
    )]
    public function getCoverageArea()
    {
    }
}