Eventos disponibles

GET /apientidades/v1/webhooks/eventos

Devuelve la lista de eventos a los que se puede suscribir un webhook.

Ejemplo de peticion

curlPython

curl -s "https://apientidades-pro.transparenciacanarias.org/apientidades/v1/webhooks/eventos" \
  -H "Authorization: Bearer $TOKEN" | jq .

response = requests.get(f"{BASE_URL}/webhooks/eventos", headers=headers)
eventos = response.json()["eventos"]
for e in eventos:
    print(f"  - {e}")

Respuesta exitosa (200)

{
  "eventos": [
    "evaluacion.abierta",
    "evaluacion.prorroga",
    "evaluacion.cierre_proximo",
    "evaluacion.cerrada",
    "resultados.provisionales",
    "resultados.definitivos",
    "alegaciones.periodo_abierto",
    "alegaciones.periodo_cierre",
    "incidencia.respuesta",
    "incidencia.cerrada",
    "documento.disponible"
  ]
}

Tabla completa de eventos

Evento	Cuando se dispara	Datos incluidos
`evaluacion.abierta`	Se abre una nueva evaluacion en la que participa la entidad	`evaluacionId`, `titulo`
`evaluacion.prorroga`	Se concede una prorroga del plazo de carga	`evaluacionId`, `fechaInicio`, `fechaFin`
`evaluacion.cierre_proximo`	Faltan pocos dias para el cierre del plazo de carga	`evaluacionId`, `fechaCierre`, `diasRestantes`
`evaluacion.cerrada`	La evaluacion se cierra y no se aceptan mas datos	`evaluacionId`, `titulo`
`resultados.provisionales`	Se publican las calificaciones provisionales	`evaluacionId`, `declaracionId`, `notaFinal`
`resultados.definitivos`	Se publican las calificaciones definitivas	`evaluacionId`, `declaracionId`, `notaFinal`
`alegaciones.periodo_abierto`	Se abre el periodo de alegaciones	`evaluacionId`, `declaracionId`, `fechaFin`
`alegaciones.periodo_cierre`	Se cierra el periodo de alegaciones	`evaluacionId`, `declaracionId`
`incidencia.respuesta`	El Comisionado responde a una incidencia de la entidad	`incidenciaId`, `titulo`
`incidencia.cerrada`	Se cierra una incidencia de la entidad	`incidenciaId`, `titulo`
`documento.disponible`	Hay un nuevo informe/documento disponible para descargar	`documentoId`, `declaracionId`, `tipo`, `descripcion`

Ejemplo de payload por evento

evaluacion.abierta

{
  "evento": "evaluacion.abierta",
  "timestamp": "2026-01-15T10:00:00Z",
  "data": {
    "evaluacionId": 11,
    "titulo": "Evaluacion ITCanarias 2025"
  }
}

evaluacion.prorroga

{
  "evento": "evaluacion.prorroga",
  "timestamp": "2026-03-16T08:00:00Z",
  "data": {
    "evaluacionId": 11,
    "fechaInicio": "2026-03-16",
    "fechaFin": "2026-04-15"
  }
}

evaluacion.cierre_proximo

{
  "evento": "evaluacion.cierre_proximo",
  "timestamp": "2026-03-10T08:00:00Z",
  "data": {
    "evaluacionId": 11,
    "fechaCierre": "2026-03-15T23:59:59Z",
    "diasRestantes": 5
  }
}

resultados.provisionales

{
  "evento": "resultados.provisionales",
  "timestamp": "2026-06-01T12:00:00Z",
  "data": {
    "evaluacionId": 11,
    "declaracionId": 5002,
    "notaFinal": 75.9
  }
}

resultados.definitivos

{
  "evento": "resultados.definitivos",
  "timestamp": "2026-09-01T12:00:00Z",
  "data": {
    "evaluacionId": 11,
    "declaracionId": 5002,
    "notaFinal": 78.2
  }
}

incidencia.respuesta

{
  "evento": "incidencia.respuesta",
  "timestamp": "2026-03-25T15:30:00Z",
  "data": {
    "incidenciaId": 201,
    "titulo": "Error al acceder al portal"
  }
}

documento.disponible

{
  "evento": "documento.disponible",
  "timestamp": "2026-06-15T10:30:00Z",
  "data": {
    "documentoId": 1,
    "declaracionId": 5002,
    "tipo": 0,
    "descripcion": "Informe de evaluacion provisional"
  }
}

Eventos recomendados

Eventos minimos

Para una integración básica, se recomienda suscribirse al menos a:

evaluacion.abierta — para saber cuándo empieza una nueva evaluación
resultados.provisionales — para recibir las calificaciones
resultados.definitivos — para las calificaciones finales
documento.disponible — para descargar informes automáticamente
incidencia.respuesta — para saber cuándo el Comisionado responde

Todos los eventos

Puede suscribirse a todos los eventos de una sola vez enviando el array completo de 11 eventos al registrar el webhook.