For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • Métodos API
      • POSTLogin
      • POSTLanguages
      • POSTCreate Appointment
      • POSTCreate Appointment Representation
      • POSTCreate Appointment Representation Guests
      • POSTCancel Appointment
      • POSTCouncil evidence summary
      • POSTCouncil Info
      • POSTCouncils
      • POSTAssign Appointment to Operator
      • POSTAppointment Documentation
      • POSTCouncil Documentation
      • POSTCompany Month Schedule
      • POSTDay slots
      • POSTShare appointment
      • POSTUpload council Act
      • POSTCompany Procedures
      • POSTReschedule Appointment
      • POSTOrganization companies
      • POSTOrganization Users
      • POSTCreate Appointment_External
      • POSTCreate Appointment Representation_External
      • POSTCreate Appointment Representation Guests_External
      • POSTCouncils_External
      • POSTCouncil Info_External
      • POSTCancel Appointment_External
      • POSTCouncil evidence summary_External
      • POSTAssign Appointment to Operator_External
LogoLogo
Métodos APIOvac

Languages

|View as Markdown|Open in Claude|
POST
/graphql/languages
POST
/graphql/languages
$curl -X POST https://api.ovac.pre.councilbox.com/graphql/languages \
>     -H "Content-Type: application/json" \
>     -d '{
>  "query": "query{\r\n    languages\r\n    {  \r\n        columnName\r\n        desc\r\n    }\r\n}",
>  "variables": {}
>}'
200Languages
1{
2  "data": {
3    "languages": [
4      {
5        "columnName": "es",
6        "desc": "Español"
7      },
8      {
9        "columnName": "en",
10        "desc": "English"
11      },
12      {
13        "columnName": "gal",
14        "desc": "Galego"
15      },
16      {
17        "columnName": "vl",
18        "desc": "Valencià"
19      },
20      {
21        "columnName": "cat",
22        "desc": "Català"
23      },
24      {
25        "columnName": "it",
26        "desc": "Italiano"
27      },
28      {
29        "columnName": "eu",
30        "desc": "Euskera"
31      }
32    ]
33  }
34}
# Languages (`query`) 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:** `https://api.ovac.pre.councilbox.com/graphql` - **Autenticación:** **No requiere**. Este es un endpoint público de parametrización. ### Cabeceras (Headers) | **Key** | **Value** | **Requerido** | **Descripción** | | --- | --- | --- | --- | | **Content-Type** | application/json | Sí | Especifica el formato JSON para el cuerpo de la petición. | ## 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`: | Campo | Tipo | Descripción | | --- | --- | --- | | **languages** | Array | Colección con todos los idiomas soportados y configurados en la plataforma. | | **languages.columnName** | String | Código o identificador técnico del idioma (ej. "es", "en", "gal"). | | **languages.desc** | String | Nombre legible y descriptivo del idioma (ej. "Español", "English"). | 💡 **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 ``` graphql query { languages { columnName desc } } ``` ### 2\. Variables de la Petición (JSON Payload) ``` json {} ``` ### 3\. Ejemplo de comando cURL ``` bash 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) ``` json { "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`.
Was this page helpful?
Previous

Login

Next

Create Appointment

Built with

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: https://api.ovac.pre.councilbox.com/graphql

  • Autenticación: No requiere. Este es un endpoint público de parametrización.

Cabeceras (Headers)

KeyValueRequeridoDescripción
Content-Typeapplication/jsonSíEspecifica el formato JSON para el cuerpo de la petición.

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:

CampoTipoDescripción
languagesArrayColección con todos los idiomas soportados y configurados en la plataforma.
languages.columnNameStringCódigo o identificador técnico del idioma (ej. “es”, “en”, “gal”).
languages.descStringNombre legible y descriptivo del idioma (ej. “Español”, “English”).

💡 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

1query {
2    languages {  
3        columnName
4        desc
5    }
6}

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

1{}

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)

1{
2    "data": {
3        "languages": [
4            {
5                "columnName": "es",
6                "desc": "Español"
7            },
8            {
9                "columnName": "en",
10                "desc": "English"
11            },
12            {
13                "columnName": "gal",
14                "desc": "Galego"
15            },
16            {
17                "columnName": "vl",
18                "desc": "Valencià"
19            },
20            {
21                "columnName": "cat",
22                "desc": "Català"
23            },
24            {
25                "columnName": "it",
26                "desc": "Italiano"
27            },
28            {
29                "columnName": "eu",
30                "desc": "Euskera"
31            }
32        ]
33    }
34}

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.

Request

This endpoint expects an object.
querystringRequired
GraphQL operation
variablesobjectOptional
GraphQL variables

Response

Successful response. GraphQL business errors may be returned inside the JSON errors field while transport status remains HTTP 200.