Datos reutilizables

API pública de es·pera

Consultas de solo lectura sobre las releases de datos que sirven el producto. La descripción OpenAPI y el catálogo normalizado permiten descubrir el contrato de forma automática.

Abrir OpenAPI Ver catálogo API Comprobar estado

Contrato

Una API versionada y sin escritura.

La URL base es https://es-pera.org/api/v1. Las operaciones admiten GET y HEAD, no requieren autenticación y devuelven JSON. No hay operaciones para modificar datos.

La API limita el tráfico anónimo: 120 solicitudes por minuto y, dentro de ese máximo, 20 por minuto para filtros y observaciones autonómicas. Una respuesta 429 incluye Retry-After; espera ese intervalo antes de reintentar.

Cada respuesta consulta las releases fijadas por el despliegue. Para conservar una extracción reproducible, guarda los identificadores devueltos por /releases/current junto con los resultados.

curl https://es-pera.org/api/v1/waiting/communities

Endpoints

Recursos publicados

Los listados aplican límites duros. Los filtros exactos, parámetros y esquemas de respuesta están en la descripción OpenAPI.

Ruta	Contenido
`GET /health`	Estado y releases accesibles
`GET /releases/current`	Metadatos de las releases activas
`GET /metrics`	Catálogo de métricas hospitalarias
`GET /entities`	Búsqueda de hospitales y complejos
`GET /entities/{entityId}`	Detalle de una entidad
`GET /waiting/releases/current`	Release autonómica activa
`GET /waiting/communities`	Cobertura autonómica disponible
`GET /waiting/facets`	Filtros disponibles por comunidad
`GET /waiting/observations`	Observaciones autonómicas paginadas

Descubrimiento

Contratos legibles por máquinas

/.well-known/api-catalog publica el catálogo Linkset conforme a RFC 9727.

/openapi.json describe todas las rutas públicas de la versión 1 mediante OpenAPI 3.1.