Las leyes, publicaciones, estadísticas, estados y otros recursos públicos pueden localizarse mediante identificadores estables.
interoperabilidad pública
APIs públicas
Las interfaces documentadas pueden ampliar la transparencia, la verificación y la reutilización sin convertir una API en fuente de autoridad ni abrir datos que no sean públicos.
Interfaces documentadasFuente oficial separadaPrivacidad por defecto
Qué debe permitir una API pública
Las interfaces públicas sirven para consultar y verificar información ya autorizada para su divulgación. Amplían el acceso y la interoperabilidad, pero no se convierten en fuente jurídica por mostrar o transmitir datos.
Las respuestas deben permitir relacionar el dato con la fuente competente, la versión y el momento de actualización.
Los formatos y contratos documentados reducen la dependencia de una única interfaz o implementación.
Contrato público de una interfaz
| Dimensión | Regla pública esperada |
|---|---|
| Versionado | Versiones identificables, cambios documentados y transición previsible. |
| Disponibilidad | Las metas solo deben publicarse cuando exista medición operativa verificable. |
| Límites | Límites de solicitudes y protección contra abusos documentados, sin discriminación arbitraria. |
| Autenticación | Consulta pública sin credencial cuando el dato ya sea público; autenticación cuando exista un ámbito personal o restringido. |
| Privacidad | Una API pública no convierte un dato personal o clasificado en dato abierto. |
| Procedencia | La respuesta debe remitir a la fuente institucional responsable. |
Ejemplos de formato — todavía no disponibles como servicio
GET /public/v1/legislation/{id}
GET /public/v1/gazette/{edition}
GET /public/v1/statistics/{series}
GET /public/v1/status
POST /verify/v1/credential
Las rutas anteriores son ejemplos de organización. No significan que esas direcciones estén publicadas o disponibles hoy.
Límite institucional: el art. 7-B permite que las interfaces de programación amplíen el acceso, pero deja claro que no adquieren autoridad institucional por sí solas. El art. 78 exige portabilidad e interoperabilidad en los módulos y servicios críticos.
Catálogo operativo aún no publicado
El portal dispone de estructuras de datos y verificación, pero la versión pública actual no presenta una API de Candeia en producción ni niveles de servicio medidos.