Skip to content

Health Check

Health Check

Prefijo: /_health, /health
Requiere Auth: No

Endpoints de verificación de salud del sistema. No requieren autenticación y son ideales para monitoreo, load balancers y herramientas de observabilidad.


GET /_health

Descripción: Health check detallado con estado de DB cloud, DB local, sync queue y disco
Requiere Auth: No

Respuesta exitosa: 200 OK

Response:

{
"status": "healthy",
"database": "cloud",
"cloud_connected": true,
"pending_sync": 0
}

Campos:

CampoTipoDescripción
statusstringEstado general: healthy, degraded, unhealthy
databasestringDB activa: cloud (PostgreSQL) o local (SQLite fallback)
cloud_connectedboolSi PostgreSQL cloud está respondiendo
pending_syncintMutaciones pendientes en cola de sincronización

cURL:

Terminal window
curl http://localhost/_health

JavaScript:

const resp = await fetch('http://localhost/_health');
const health = await resp.json();
if (health.status === 'healthy') console.log('API OK');

GET /health

Descripción: Health check simplificado (alias de /_health)
Requiere Auth: No

Misma respuesta que /_health. Endpoint alternativo para compatibilidad con herramientas de monitoreo que esperan /health.

cURL:

Terminal window
curl http://localhost/health