> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryzeapi.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Health

> Sondeo combinado, proceso, base de datos y dependencias opcionales

**Auth:** Ninguna • **Rate limit:** Bypass (fuera del límite global) • **Idempotente:** sí

## Descripción

Endpoint **abierto** (sin token) que devuelve una instantánea del estado de la API basada en verificaciones de dependencias (DB siempre, además de sondeos opcionales como S3 cuando esté configurado). Omite el rate limit y CORS para que monitores externos puedan consultarlo sin credenciales.

## Ejemplo

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://ryzeapi.cloud/health"
  ```
</RequestExample>

## Respuesta, saludable

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "status": "ok",
    "service": "RyzeAPI",
    "uptime": "12h34m56s",
    "timestamp": "2026-04-28T14:35:21Z",
    "checks": {
      "db": "ok"
    }
  }
  ```
</ResponseExample>

## Respuesta, degradada

```json 503 Service Unavailable theme={null}
{
  "status": "degraded",
  "service": "RyzeAPI",
  "uptime": "12h34m56s",
  "timestamp": "2026-04-28T14:35:21Z",
  "checks": {
    "db": "fail: connection refused"
  }
}
```

## Campos

| Campo       | Descripción                                                                                            |
| ----------- | ------------------------------------------------------------------------------------------------------ |
| `status`    | `"ok"` cuando todas las verificaciones pasan, `"degraded"` cuando alguna falla.                        |
| `service`   | Siempre `"RyzeAPI"`.                                                                                   |
| `uptime`    | Tiempo desde que arrancó el proceso, en formato de duración de Go (p. ej., `12h34m56s`, `1h2m3.456s`). |
| `timestamp` | Hora de la respuesta en RFC 3339 (UTC).                                                                |
| `checks`    | Mapa `name → "ok" \| "fail: <razón>"` para cada dependencia verificada.                                |

<Note>
  Las entradas en `checks` aparecen condicionalmente: `db` siempre está presente; otras dependencias (p. ej., `s3`) solo aparecen cuando están configuradas en el servidor.
</Note>

## Uso en monitores de uptime

Apunta un servicio de monitoreo (UptimeRobot, Better Stack, Pingdom, etc.) a `GET /health`:

* `200` → API saludable.
* `503` → API degradada, dispara la alerta.

## Notas

* No es necesario enviar la cabecera `token`. Los tokens enviados se ignoran.
* El endpoint **no cuenta** para el límite global de `100 req/min`, y puede llamarse sin restricción por sondas externas.

## Relacionado

<CardGroup cols={2}>
  <Card title="Resumen" icon="heart-pulse" href="/es/api/observability/overview">
    Dónde se ubica el endpoint en el ciclo de vida de la API.
  </Card>

  <Card title="Tipos de error" icon="triangle-exclamation" href="/es/guide/errors">
    Tabla de estados HTTP utilizados por RyzeAPI.
  </Card>
</CardGroup>