Referencia API

GET /v1/health

Comprueba el estado de salud de la API de Rueda Lens.

Devuelve el estado de salud actual de la API. Este endpoint realiza comprobaciones ligeras para verificar que la API está operativa.

Endpoint

GET https://api.ruedalens.com/v1/health

Autenticación

No requerida. Este es un endpoint público.

Solicitud

curl https://api.ruedalens.com/v1/health

Respuesta

Operativa — `200 OK`

{
  "status": "healthy",
  "version": "1.0.0",
  "timestamp": "2026-02-08T12:00:00.000Z"
}

No operativa — `503 Service Unavailable`

{
  "status": "unhealthy",
  "version": "1.0.0",
  "timestamp": "2026-02-08T12:00:00.000Z"
}

Campos de la respuesta

Campo	Tipo	Descripción
`status`	`string`	`"healthy"` o `"unhealthy"`
`version`	`string`	Versión actual de la API
`timestamp`	`string`	Marca temporal ISO 8601 de la comprobación de estado

Casos de uso

Monitorización

# Comprobar el estado de salud cada 60 segundos
*/1 * * * * curl -sf https://api.ruedalens.com/v1/health || echo "API caída"

Comprobación previa

async function isApiAvailable() {
  try {
    const res = await fetch('https://api.ruedalens.com/v1/health');
    const data = await res.json();
    return res.ok && data.status === 'healthy';
  } catch (error) {
    return false;
  }
}

Notas

Este endpoint no consume cuota de la API
Tiempo de respuesta habitual: < 500 ms
Devuelve 200 OK cuando todos los sistemas están operativos
Devuelve 503 Service Unavailable cuando dependencias críticas no están disponibles