Get Languages

Esta operación permite consultar el listado de los idiomas soportados en la plataforma OVAC. Su propósito principal es exponer los códigos técnicos normalizados (columnName) que los integradores deben capturar y enviar en otras llamadas de la API para establecer el idioma en el cual el ciudadano visualizará su interfaz y recibirá las notificaciones.

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: No requiere. Este es un endpoint público de parametrización.

Cabeceras (Headers)

Referencia de la API

Parámetros de Entrada (Variables)

Este método no requiere ningún parámetro ni bloque de variables de entrada.

Campos de Respuesta (Payload)

La consulta devuelve un array de objetos dentro del campo languages:

💡 Nota de Integración: El valor recuperado en columnName es el identificador exacto que espera recibir la API en variables ulteriores (como participant.language en el flujo de Create Appointment) para personalizar la experiencia del asistente. Se recomienda validar con el administrador del sistema cuáles de estos idiomas están activos para tu organización antes de desplegarlos en la interfaz.

Ejemplos de Código y Peticiones

1. Consulta GraphQL

query {
    languages {  
        columnName
        desc
    }
}

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

{}

3. Ejemplo de comando cURL

curl --location "https://api.ovac.pre.councilbox.com/graphql" \
--header "Content-Type: application/json" \
--data '{"query":"query{\n    languages\n    {  \n        columnName\n        desc\n    }\n}","variables":{}}'

4. Respuesta Esperada (200 OK)

{
    "data": {
        "languages": [
            {
                "columnName": "es",
                "desc": "Español"
            },
            {
                "columnName": "en",
                "desc": "English"
            },
            {
                "columnName": "gal",
                "desc": "Galego"
            },
            {
                "columnName": "vl",
                "desc": "Valencià"
            },
            {
                "columnName": "cat",
                "desc": "Català"
            },
            {
                "columnName": "it",
                "desc": "Italiano"
            },
            {
                "columnName": "eu",
                "desc": "Euskera"
            }
        ]
    }
}

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