Request agenda information

View as Markdown
# Request agenda information (`query`) Esta operación permite consultar el detalle técnico y el estado de consolidación de un paso específico a partir de su identificador único. Su principal función es auditar las interacciones en tiempo real, recuperando el tipo de punto, el enunciado legal y la colección completa de respuestas o consentimientos emitidos (`votings`) por los intervinientes de la sesión. ### 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) | Parámetro | Descripción | Requerido | Tipo | | --- | --- | --- | --- | | id | Identificador único del punto del paso de la cita/gestión que se desea consultar. | SI | Int | ### Campos de respuesta (Payload) La consulta devuelve una estructura detallada bajo el resolvedor raíz `addAgendaPoint:` | Parámetro | Descripción | Tipo | | --- | --- | --- | | agenda | Objeto contenedor con las propiedades del paso consultado. | Object | | agenda.id | Identificador interno único del paso de la cita/gestión. | Integer | | agenda.subjectType | Código numérico taxonómico que representa la tipología del punto. <br>`9` -> Consentimiento explícito | Integer | | agenda.agendaSubject | Título literal, enunciado o pregunta formulada a los participantes. | String | | agenda.votings\[\] | Colección o array de registros con las interacciones recopiladas. | Array | | agenda.votings\[\].id | Identificador único del registro de consentimiento individual. | Integer | | agenda.votings\[\].vote | Valor numérico que representa estado de la respuesta, para los pasos de tipo 9 (consentimiento de aceptación/rechazo) <br>`-1` -> Sin acción <br>`0` -> Rechazado <br>`1` -> Aceptado | Integer | ## Ejemplos de código y peticiones ### 1\. Consulta GraphQL ``` graphql query Agenda ( $id: Int! ){ agenda( id: $id ) { id subjectType agendaSubject votings { id vote } } } ``` ### 2\. Variables de la Petición (JSON Payload) ``` json { "id": 91051 } ``` ### 3\. Ejemplo de comando cURL ``` bash curl --location 'https://api.ovac.pre.councilbox.com/graphql' --header 'Content-Type: application/json' --header 'x-jwt-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqOTY3ZS04MDY3LTRiMDUtYjQ0MS0zZmFhYWVlN2M3ZDUiLCJ1c2VyX2lkIjozNDc2LCJ0b2tlbl90eXBlIjoidXNlciIsImlhdCI6MTc4MTA3NjAyMH0.aXYLM7tX0xYjzi4m7gGNUlZ4Dj15cG-iIakmzGwhDTs' --data '{"query":"query Agenda (\r\n $id: Int!\r\n\r\n){\r\n agenda(\r\n id: $id\r\n ) {\r\n id\r\n subjectType\r\n agendaSubject\r\n votings {\r\n id\r\n vote\r\n }\r\n }\r\n}","variables":{"id":12345}}' ``` ### 4\. Respuesta esperada (200 OK) ``` json { "data": { "agenda": { "id": 91051, "subjectType": 9, "agendaSubject": "TEST API", "votings": [ { "id": 40290, "vote": -1 } ] } } } ``` > **Nota OpenAPI/Fern:** esta operación GraphQL se documenta como `/graphql/agenda` para que Fern pueda mostrarla como operación independiente. La ruta técnica real de ejecución es `POST /graphql`.

Authentication

x-jwt-tokenstring
JWT token obtained from Login.

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.