El endpointDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/danitocsc/transporte-unrc-web-public/llms.txt
Use this file to discover all available pages before exploring further.
/api/health es el punto de verificación de estado del servidor de Transporte Tijuana. Su único propósito es confirmar que la aplicación Next.js está en línea y respondiendo solicitudes. Es ligero, sin estado, y no requiere autenticación ni parámetros de entrada.
Detalles del endpoint
| Propiedad | Valor |
|---|---|
| Método | GET |
| Ruta | /api/health |
| Autenticación | No requerida |
| Caché | Ninguna (force-dynamic) |
| Implementación | web/app/api/health/route.ts |
Este endpoint está marcado con
export const dynamic = 'force-dynamic', lo que instruye a Next.js a evaluar el handler en cada solicitud sin usar respuestas en caché. Esto garantiza que el healthcheck refleje el estado real del servidor en tiempo de ejecución, no una respuesta almacenada estáticamente durante el build.Uso con Docker Compose
El sitio está configurado con un healthcheck de Docker Compose que consulta este endpoint periódicamente para determinar si el contenedor está listo para recibir tráfico:- Intervalo: cada 30 segundos
- Timeout: 10 segundos
- Reintentos: 3 antes de marcar el contenedor como
unhealthy
200 OK, Docker lo considera saludable. Si el servidor crashea o un error no manejado impide que Next.js responda, el contenedor es marcado como unhealthy y puede ser reiniciado automáticamente por el orquestador.
Ejemplo de uso
Respuesta esperada
Código fuente
El handler es intencionalmente minimalista. No accede a bases de datos, no lee archivos del sistema de archivos, ni llama a servicios externos — únicamente confirma que el proceso de Node.js está vivo y que el router de Next.js pudo despachar la solicitud.web/app/api/health/route.ts
Tabla de respuestas posibles
| Código HTTP | Cuerpo | Significado |
|---|---|---|
200 OK | {"status":"ok"} | El servicio está en línea y funcionando correctamente |
500 Internal Server Error | Página de error de Next.js | El servidor crasheó o se produjo una excepción no controlada que impide que la solicitud sea procesada |