API de Integración T-Canaria

Bienvenido a la documentación técnica de la API de Integración T-Canaria, la interfaz programática que permite a las administraciones públicas integrar sus sistemas con el Sistema de Evaluación de Transparencia del Comisionado de Transparencia de Canarias.

¿Qué es esta API?

La API de Integración permite que los sistemas internos de las administraciones públicas (portales de transparencia, registros de solicitudes, cuadros de mando) se comuniquen automáticamente con T-Canaria, sin necesidad de acceder manualmente al portal web.

¿Qué se puede hacer con la API?

Funcionalidad	Descripción
Evaluaciones	Consultar evaluaciones activas, plazos y calendario
Declaraciones	Consultar estado, inicializar y obtener análisis
Publicidad activa	Enviar URLs del portal de transparencia (individual o masivo)
Cuestionarios	Responder cuestionarios de soporte web, transparencia voluntaria y derecho de acceso
Derecho de acceso	Enviar estadísticas de solicitudes de acceso a la información
Resultados	Consultar notas, ranking y descargar informes PDF
Documentos	Descargar informes provisionales, definitivos y justificantes
Usuarios	Consultar usuarios autorizados de la entidad
Incidencias	Crear, responder y cerrar incidencias con el Comisionado
Webhooks	Recibir notificaciones automáticas cuando ocurren eventos

URL base

https://apientidades-pro.transparenciacanarias.org/apientidades/v1/

Flujo básico de uso

sequenceDiagram
    participant E as Sistema de la Entidad
    participant A as API T-Canaria

    E->>A: POST /auth (API Key)
    A-->>E: Token JWT (1 hora)

    E->>A: GET /evaluaciones
    A-->>E: Evaluaciones activas

    E->>A: PUT /declaraciones/{id}/pa (URLs)
    A-->>E: 200 OK

    E->>A: PUT /declaraciones/{id}/cuestionarios/{id}
    A-->>E: 200 OK

    E->>A: GET /declaraciones/{id}/notas
    A-->>E: Puntuaciones

Requisitos previos

Para utilizar la API necesita:

API Key — proporcionada por el equipo del Comisionado de Transparencia
IP autorizada (opcional) — si se configuró restricción de IP, solo se aceptan peticiones desde esas IPs
Cliente HTTP — cualquier lenguaje de programación capaz de hacer peticiones HTTP (Python, Java, .NET, PHP, curl, etc.)

Primer paso

Vaya a la sección Obtener API Key para comenzar.

Características técnicas

Aspecto	Detalle
Protocolo	HTTPS (TLS 1.2+)
Formato	JSON (camelCase)
Autenticación	API Key + JWT Bearer (1 hora)
Errores	RFC 7807 Problem Details
Paginación	`?page=0&size=20` (máximo 100)
Cabeceras	`X-Correlation-ID`, `X-Api-Version: 1.0`
Versionado	`/v1/` en la URL

Soporte

Si necesita ayuda con la integración:

Contacte con el equipo técnico del Comisionado de Transparencia
Cree una incidencia desde la API (POST /apientidades/v1/incidencias)
Consulte este manual para ejemplos detallados de cada endpoint