# Monitorización de API

Source: https://instatus.com/help/es/monitoring/api

Los monitores de API envían una petición HTTP configurable a un endpoint cada 30 segundos y te avisan cuando no responde, va lento o devuelve datos incorrectos. Tú controlas el método, las cabeceras, el cuerpo y la autenticación, y validas el código de estado, el cuerpo JSON, las cabeceras y el tiempo de respuesta.

Igual que con [otros monitores](https://instatus.com/help/es/monitoring), si un monitor de API detecta un problema puedes trabajar con tu equipo para [resolver la incidencia](https://instatus.com/help/es/incident-response) y, si quieres, actualizar tu [página de estado](https://instatus.com/help/es/status-page).

| At a glance | Details |
| :-- | :-- |
| [Frecuencia](https://instatus.com/help/es/monitoring/api#ajustes-avanzados) | Cada 30 segundos |
| [Métodos HTTP](https://instatus.com/help/es/monitoring/api#configuración-de-la-petición) | GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD |
| [Cuerpo de la petición](https://instatus.com/help/es/monitoring/api#configuración-de-la-petición) | JSON, datos de formulario, GraphQL, texto plano |
| [Autenticación](https://instatus.com/help/es/monitoring/api#configuración-de-la-petición) | Autenticación básica, clave de API, token Bearer |
| [Condiciones](https://instatus.com/help/es/monitoring/api#el-monitor-se-considera-correcto-si) | Código, tiempo de respuesta, cuerpo, ruta JSON, cabeceras |
| [Ubicaciones](https://instatus.com/help/es/monitoring/api#ajustes-avanzados) | Estados Unidos, Canadá, Europa, Asia |

![Monitor](https://instatus.com/help/monitors/item.png)

## ¿Qué comprueba un monitor de API?

- Prueba tus endpoints de API desde varias ubicaciones del mundo cada 30 segundos.
- Valida códigos de estado HTTP, cuerpo JSON, cabeceras y tiempos de respuesta.
- Incluye cabeceras personalizadas, parámetros de consulta o cargas JSON.
- Recibe avisos inmediatos si un endpoint está caído, lento o devuelve resultados inesperados.
- Integra Slack, correo, SMS, llamadas telefónicas, webhooks y más.

## ¿Cómo añado un monitor de API?

Ve a tu proyecto → Monitores → Añadir monitor, elige **API**, introduce la URL del endpoint, configura la petición y define las condiciones que indican que el endpoint funciona correctamente.

![Añadir monitor de API](https://instatus.com/help/monitors/API.png)

### Tipo de monitor

Elige **API** como tipo de monitor.

![Tipo de monitor API](https://instatus.com/help/monitors/type-api.png)

Introduce la URL del endpoint que quieres monitorizar; por ejemplo,  
`https://api.tuservicio.com/v1/users`.

### Configuración de la petición

Puedes adaptar por completo tu petición de API:

- **Método HTTP:** `GET`, `POST`, `PUT`, `PATCH`, `DELETE`, `OPTIONS` o `HEAD`
- **Cuerpo:** envía JSON, datos de formulario, GraphQL o texto plano con tu petición
- **Autenticación:** añade autenticación básica, clave de API o autorización con token Bearer
- **Parámetros de consulta:** añade pares clave/valor a la URL de la petición
- **Cabeceras:** añade las cabeceras personalizadas que necesite tu petición

### El monitor se considera correcto si

Un monitor de API tiene éxito cuando se cumplen todas las comprobaciones indicadas.  
Puedes definir una o varias de estas comprobaciones:

- **Código de estado:** por ejemplo, que la respuesta sea `200 OK`
- **Tiempo de respuesta:** por ejemplo, menos de `1 segundo`
- **El cuerpo contiene:** por ejemplo, `"success": true`
- **Ruta JSON:** por ejemplo, que `data.status` sea igual a `"active"`
- **La cabecera contiene:** por ejemplo, `Content-Type: application/json`

Si alguna de estas condiciones no se cumple, el monitor se marcará como **caído** y se enviarán las alertas según tus [ajustes de alertas](https://instatus.com/help/es/monitoring/alerts).

### Ajustes avanzados

![Ajustes avanzados del monitor](https://instatus.com/help/monitors/advanced-settings.png)

- **Nombre descriptivo:** asigna a tu monitor un nombre claro para identificarlo fácilmente.
- **Ejecutar comprobaciones cada:** decide con qué frecuencia se prueba el endpoint.
- **Ejecutar desde:** elige las ubicaciones de prueba (Estados Unidos, Canadá, Europa, Asia).
- **Añadir a la página de estado:** muestra públicamente la disponibilidad y las estadísticas de respuesta de tu API.
- **Cuando un monitor falla:** abre una incidencia, notifica a los suscriptores o publica en tu página de estado.
- **Cuando un monitor se recupera:** resuelve las incidencias y actualiza tu página de estado automáticamente.

¡Enhorabuena, has añadido tu primer monitor de API!

- [Monitorización cron](https://instatus.com/help/es/monitoring/cron): Aprende a monitorizar tareas programadas y procesos en segundo plano