Get Available Appointment Agendas

Esta operación permite obtener el desglose estructurado de todos los pasos (agendas) vinculados a una cita o gestión específica. Es el método idóneo para recuperar de forma masiva la configuración interactiva de una sesión junto con el histórico completo de respuestas (votings) recopiladas.

Detalles de la Solicitud

• Método HTTP: POST

• URL PRE: https://api.ovac.pre.councilbox.com/graphql

• URL PRO: https://api.ovac.councilbox.com/graphql

Autenticación

Tipo: API Key**
Header:** x-jwt-token
Ubicación: Header HTTP_
Ejemplo:_ x-jwt-token: eyJhbGciOiJIUzI1NiIsInR5cCI6...

Referencia de la API

Parámetros de entrada (variables)

Campos de respuesta (Payload)

La consulta devuelve un árbol jerárquico bajo el campo raíz de datos council:

Ejemplos de código y peticiones

1. Consulta GraphQL

query Council($councilId: Int!){
    council(id: $councilId){
        agendas {
            id
            name
            votings {
                id
                vote
            }
        }
    }
}

2. Variables de la Petición (JSON Payload)

{
    "councilId": 65181
}

3. Ejemplo de comando cURL

curl --location 'https://api.ovac.pre.councilbox.com/graphql' \
--header 'Content-Type: application/json' \
--header 'x-jwt-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJiNmQxOTY3ZS04MDY3LTRiMDUtYjQ0MS0zZmFhYWVlN2M3ZDUiLCJ1c2VyX2lkIjozNDc2LCJ0b2tlbl90eXBlIjoidXNlciIsImlhdCI6MTc4MTA3NjAyMH0.aXYLM7tX0xYjzi4m7gGNUlZ4Dj15cG-iIakmzGwhDTs' \
--data '{"query":"query Council($councilId: Int!){ council(id: $councilId){ agendas { id name votings { id vote } } } }","variables":{"councilId":65167}}'

4. Respuesta esperada (200 OK)

{
    "data": {
        "council": {
            "agendas": [
                {
                    "id": 91079,
                    "name": "La dirección proporcionada es Calle Nueva, número 7 en Teo, A Coruña CP 15883",
                    "votings": [
                        {
                            "id": 40291,
                            "vote": -1
                        }
                    ]
                },
                {
                    "id": 91080,
                    "name": "Nueva dirección",
                    "votings": [
                        {
                            "id": 40292,
                            "vote": 0
                        }
                    ]
                },
                {
                    "id": 91081,
                    "name": "",
                    "votings": [
                        {
                            "id": 40293,
                            "vote": 1
                        }
                    ]
                }
            ]
        }
    }
}

Nota OpenAPI/Fern: esta operación GraphQL se documenta como /graphql/council para que Fern pueda mostrarla como operación independiente. La ruta técnica real de ejecución es POST /graphql.