Las APIs fallan de forma distinta a los sitios web: responden 200 con un cuerpo de error, se vuelven lentas antes de caer y dependen de colas que nadie vigila. Así se monitorizan.
Valida el cuerpo de la respuesta
Elige un endpoint de salud que compruebe la base de datos y la caché, devuelva JSON, y monitoriza un campo como $.status igual a ok.
Autentícate
Usa un token de solo lectura en una cabecera Authorization. Rótalo como cualquier otro secreto.
Vigila la latencia
Establece un umbral de aproximadamente el doble de tu p95 habitual. Una API lenta suele ser un indicador temprano de una caída.
Monitoriza los workers
Los consumidores de colas y los cron jobs necesitan monitores heartbeat: el trabajo hace ping a una URL cuando termina.
Agrúpalo en una página de estado
Muestra la API, los webhooks y los trabajos en segundo plano como componentes separados para que los clientes vean exactamente qué está afectado.