APISalud y estado
Cómo saber si la API responde y qué capacidades están afectadas.
GET /v1/health dice si la API responde. GET /v1/status dice qué capacidades de tu empresa están afectadas. No hay página pública de estado.
| Ruta | Acceso | Para qué | Responde |
|---|---|---|---|
GET /v1/health | Pública | Saber si la API responde | ok, degraded o down, sin detalle |
GET /v1/status | Con llave | Saber qué capacidades están afectadas | Estado por capacidad |
/v1/health sale de una medición en segundo plano, sin llave y sin gastar cuota:
status | HTTP | Qué significa |
|---|---|---|
ok | 200 | La API y sus servicios internos responden |
degraded | 200 | La API responde, pero un servicio interno no, como el que procesa los pagos; o la medición tiene más de 15 segundos |
down | 503 | La API no puede atender peticiones |
degraded responde 200: si tu monitor sólo mira el código HTTP, no lo verá. Lee también status.
Capacidades: payments_mxn, payments_latam, payments_pix, collections, webhooks, api. Estados: operational, degraded, outage, unknown, not_enabled. Una capacidad que tu empresa no tiene sale como not_enabled.
Qué hacer
| Lo que ves | Qué hacer |
|---|---|
degraded en /v1/health | Consulta GET /v1/status para ver qué está afectado |
degraded en una capacidad | Sigue operando. Espera más demora y más reintentos |
outage en payments_mxn o payments_latam | Pausa pagos nuevos de esa capacidad. Conserva cola local. No generes claves nuevas |
unknown | Trátalo como degraded y revisa de nuevo en 1 minuto |
outage en webhooks | Consulta GET /v1/events para recuperar eventos |
503 | Reintenta con la misma clave y espera exponencial con variación |
| Timeout en un pago | Repite con la misma Idempotency-Key. Nunca lo des por fallido |
/v1/health no responde | Caída total: ver abajo |
Quien tiene login ve lo mismo en la pantalla Estado del panel, con incidentes e historial de 90 días.
Caída total
/v1/healthy/v1/statusno responderán, y el panel probablemente tampoco.- Tu integración debe contemplarlo desde el inicio: cola local, reintentos con espera, tope de reintentos y alerta propia.
- No cambies llaves, IP ni claves de idempotencia durante la caída.
- Escribe a soporte, que no depende de la API.
Errores comunes
- Usar
/v1/healthpara decidir si un pago ocurrió. Consulta elpay_. - Tratar sólo el
503como problema:degradedllega con200. - Pausar todo por una capacidad degradada: pausa sólo lo afectado.