Saltar al contenido

Monitorización de API que detecta la respuesta incorrecta.

Tu endpoint de salud no puede ver un flujo de inicio de sesión roto. Uptimia inicia sesión, llama a la API y comprueba las respuestas — así que obtienes el paso que ha fallado, no un ticket de soporte.

Prueba gratuita de 30 días · hasta 50 monitores de API Sin tarjeta de crédito Conforme al RGPD
Intervalo más rápido
60s
Sondas para confirmar
3
Sondas
171+
Países con sondas
70+

La solicitud que volvió mal

Un flujo de pedido de cinco pasos, ejecutado según lo programado. El inicio de sesión, la búsqueda del pedido y el total pasan todos — la solicitud que los sigue, no.

paso 1 Iniciar sesión — obtener el tokenEl inicio de sesión se completa; el token que devuelve llega a {{token}} tú: sin sobresaltos
pasos 2–3 Llamar a la API con élGET /orders obtiene {{order_id}}; el pedido debe mostrar el total correcto tú: sin sobresaltos
paso 4 Añadir la nota del pedido fallaLa aserción indica el fallo: la nota nunca se creó tú: sin sobresaltos
14:32 Confirmado desde otra sonda — y entonces te avisanOtras sondas vuelven a ejecutarlo y coinciden; la alerta ya indica el paso 4 avisado: con la causa
paso 4indicado en la alerta
"El paso 4 no ha superado su comprobación."14:32
Esa es toda la investigación, hecha antes de que abrieras el portátil: el paso, la aserción y la confirmación de que no es la mala noche de una sola sonda. La solución empieza en la solicitud que falla — no en "la API está caída".
failing step namedexact assertion quotedconfirmed from other locationsstatus · timing · headers · values — per step
¿Y con solo un ping? /health sigue respondiendo bien todo el tiempo — un paso roto en lo más profundo del flujo nunca lo toca. El primer aviso es un cliente que no pudo completar el proceso, y una búsqueda entre registros para encontrar dónde se rompió. descubierto por un cliente

Lo que un ping nunca ve

Una solicitud que se completa pero devuelve datos incorrectos sigue siendo un fallo, y un paso roto tres solicitudes más adentro nunca llega a tocar tu endpoint de salud. Apunta un monitor a tu propia API — o a las APIs de terceros de las que dependes, y sabe si el problema son ellos, no tú.

Códigos de estado & encabezadosLa respuesta que esperas, en cada paso
Valores en la respuestaCualquier campo, comprobado paso a paso
Fallos a mitad del flujoEl paso 3 falla — un ping nunca lo ve
Desviación en la respuestaForma incorrecta, campos ausentes
15 pasos por cadena todo el flujo, ejecutado de verdad
La autenticación fallaTokens caducados, inicios de sesión rechazados
TLS & errores de conexiónNegociaciones fallidas y sockets rechazados
Límite de tiempo de respuestaCada paso dentro de su límite
Las alertas indican el paso y la aserción que ha fallado: una solicitud fallida, un valor incorrecto en la respuesta, un campo ausente, un paso lento, un error de conexión o un inicio de sesión que ha dejado de funcionar. paso + aserción

Cadenas, aserciones y tiempos

El flujo

Encadena hasta 15 solicitudes

Cada paso puede extraer un valor de la respuesta — un token, el id de un pedido — en una variable que los pasos posteriores insertan como {{name}}. Un solo monitor cubre el recorrido completo, desde el inicio de sesión hasta la limpieza final.

  • 6 métodos HTTP — GET, POST, PUT, PATCH, DELETE o HEAD, en cualquier orden
  • Extrae valores en variables — referéncialas donde quieras más adelante como {{name}}
  • Encabezados, cuerpo y tiempo de espera personalizados por paso — duplica un paso para avanzar rápido
Recorre el mismo flujo con un navegador real
POST/auth/login1 aserción
GET/orders2 aserciones
GET/orders/{{order_id}}3 aserciones
POST/orders/{{order_id}}/notes1 aserción
DEL/sessions/{{token}}limpieza
Cadena superada1.94 s
Un solo monitor ejecuta todo el recorrido — desde el inicio de sesión hasta la limpieza — con la frecuencia de hasta una vez por minuto.
5 steps7 assertions2 variables
Un paso sin aserciones se da por superado en cuanto la solicitud se completa — añade comprobaciones solo donde importan. cualquier éxito
Aserciones

Comprueba estado, valores y tiempos

Añade las comprobaciones que un paso debe superar: un estado exacto, un límite de tiempo de respuesta, un valor en el cuerpo de la respuesta, un encabezado o un texto en la respuesta. Cuando una falla, la ejecución muestra lo que ha obtenido — y Ejecutar prueba llama al endpoint real antes de guardar.

  • Estado y tiempo de respuesta — el paso falla si el código es incorrecto o la respuesta tarda demasiado
  • Valores dentro de la respuesta — señala un campo y exige que esté presente y sea correcto
  • Encabezados y texto del cuerpo de la respuesta — exige el valor de un encabezado, o un texto que debe estar presente o ausente
Vigila el texto de una página, no solo su estado
Ejecutar prueba200 · 191 ms
GET /orders/8842 · paso 3 — la respuesta real, obtenida de verdad antes de guardar.
{
  "id": 8842,
  "status": "paid",
  "total": 4210
}
el estado es 200se obtuvo 200
$.status es igual a "paid"se obtuvo "paid"
tiempo de respuesta inferior a 500 msse obtuvieron 191 ms
{{order_id}} extraído = 8842 alimenta el siguiente paso — resaltado en la respuesta en vivo de arriba. = 8842
Tiempos

DNS, TLS o tu propio backend

"La API va lenta" nunca es toda la historia. El tiempo de cada paso se divide en cinco fases — DNS, conexión, TLS, espera, recepción — para que veas qué paso se está retrasando y si el motivo está en la red o en tu backend.

  • Tiempos en cinco fases por paso — DNS, conexión, TLS, espera, recepción
  • Gráfico de tiempo de respuesta por paso — apilado, con marcadores de incidentes
  • El paso más lento y las ejecuciones más lentas aparecen en la página de detalle del monitor
Tiempos fase a fase para páginas web
Paso 4 — lento14:32:16
POST /orders/8842/notes · 1.389 ms en total, dividido en cinco fases.
dns18 ms
conexión31 ms
tls44 ms
espera1,284 ms
recepción12 ms
Red — bien
dns 18 · connect 31 · tls 44
93 ms
Backend — el retraso
tiempo de procesamiento antes del primer byte
1,284 ms
El paso más lento y las ejecuciones más lentas están en la página del monitor — un gráfico apilado por paso muestra cuándo empezó el retraso. el más lento
Secretos

Claves de API reales, siempre enmascaradas

Guarda contraseñas, claves de API y tokens como variables secretas: de solo escritura, enmascaradas al leerlas y ocultas en las URLs, encabezados y fragmentos de respuesta que se muestran. Nada sensible acaba en tu historial de ejecuciones.

  • Variables secretas de solo escritura — enmascaradas siempre que se vuelven a leer
  • Ocultas dondequiera que se muestren — URLs, encabezados y fragmentos del cuerpo
  • Los valores extraídos que coinciden con un secreto tampoco se muestran nunca
Monitorización de páginas protegidas por inicio de sesión
API_KEYsecreto
••••••••••••••••solo escritura
Guardado una vez y nunca se vuelve a mostrar — una lectura devuelve value:'' · has_value:true.
Encabezado del paso 1 — lo que configuras
Authorization: Bearer {{API_KEY}}
Historial de ejecuciones — lo que se guarda
Authorization: Bearer [redacted]
Los valores extraídos que coinciden con un secreto tampoco se muestran nunca — nada sensible llega al historial de ejecuciones. enmascarado

Encadena las solicitudes una vez.Obtén el nombre del paso que falla.

Cada paso, cada aserción, cada canal de alertas — gratis durante 30 días, y nada de eso es un complemento de pago.

Empieza tu prueba gratuita de 30 días
30 días gratis sin tarjeta de crédito cancela cuando quieras

Cómo funciona la monitorización de API

Crea la cadena, pruébala contra la API real y Uptimia la ejecutará según lo programado desde nuestra red — no hay nada que instalar.

Paso 1crear

Encadena tus solicitudes

Añade cada solicitud en orden, configura encabezados y cuerpo, y extrae en variables los valores que necesiten los pasos siguientes.

Paso 1 · solicitud
POST /auth/login
extraer $.token → {{token}}
Paso 2 · solicitud
GET /orders
Paso 2probar

Añade aserciones y ejecuta una prueba

Añade las comprobaciones que cada paso debe superar y después ejecuta Ejecutar prueba contra el endpoint real — resultados completos por paso, antes de guardar.

Aserciones · paso 3
el estado es 200$.status = "paid"
menos de 500 ms
Ejecutar prueba · 5/5 pasos superados en 1,9 s
Paso 3cada minuto

Lo ejecutamos según lo programado

Una sonda ejecuta toda la cadena en una sola ida y vuelta, comprueba cada aserción y guarda los resultados por paso — los fallos se confirman desde otras sondas antes de avisar.

Ejecución correcta — 5/5 pasos
14:31 · 1,8 s · todas las aserciones superadas
a tiempo
Ejecución fallida — paso 4
14:32 · se esperaba 201, se obtuvo 500
avisando

También incluido

Slack, PagerDuty, SMS y 9 más

Una alerta de API indica el paso que ha fallado y la causa, y se envía a los mismos contactos que usa cualquier monitor de Uptimia — correo electrónico, SMS, Slack, Teams, Discord, PagerDuty, webhooks y más.

paso 3 · $.status: se esperaba "paid", se obtuvo "pending" → Slack · Email · PagerDuty

Confirmado desde otras sondas antes de avisar

Una ejecución fallida se vuelve a intentar primero desde otras sondas disponibles.

re-ejecutado en otra sonda · coincide antes de abrirse

Duplica un paso

Construye una cadena larga rápido — copia una solicitud y ajústala.

paso 3 → duplicar → paso 4

Exportación de RCA del incidente

Un incidente cerrado conserva el detalle a nivel de paso — expórtalo.

RCAPDFHTML

Tiempo de espera, encabezados y cuerpo por solicitud

Da a cada solicitud su propio tiempo de espera, encabezados y cuerpo.

tiempo de espera 10 s · 20 encabezados · cuerpo de 64 KB

Todos los tipos de monitor en una sola cuenta

Tus monitores de API conviven con los de disponibilidad, SSL, heartbeat y DNS — mismos contactos, grupos y roles.

Checkout order flowAPI www.caldmont.comUPTIME db-backup · nightlyHEARTBEAT

¿Qué es la monitorización de API?

La monitorización de API es un servicio automatizado que ejecuta una secuencia real de solicitudes HTTP contra tu API REST o endpoint JSON según lo programado y te avisa cuando un paso devuelve el estado incorrecto, los datos incorrectos o tarda demasiado. Vigila el flujo de trabajo que hay detrás de un endpoint, no solo si el servidor ha respondido.

Mientras todo funciona

¿Cómo funciona la monitorización de API?

Uptimia
ejecuta la cadena
5 pasos · según lo programado
Tu API
cada comprobación se supera

Una sonda ejecuta cada paso en una sola ida y vuelta, evalúa cada aserción y guarda los resultados por paso como tu historial de ejecuciones.

Cuando una comprobación falla

Confirmar primero, avisar después

Tu API
paso 4 · fallido
se repite · en otras sondas
Uptimia
abre el incidente

el paso 4 no supera su comprobación → se abre el incidente, la alerta indica el paso

Las comprobaciones

¿Qué verifica un monitor de API?

Un paso se supera con una respuesta correcta por defecto. Añade aserciones y la ejecución deberá demostrarlas — un estado exacto, un límite de tiempo de respuesta, un valor en la respuesta, un encabezado o un texto del cuerpo.

Herramienta gratuita: comprueba estado & encabezados de cualquier endpoint
ComprobaciónQué demuestraEjemplo
Código de estadoel endpoint ha respondido como se esperabaes 201 · es uno de 200/204 · cualquier 2xx
Tiempo de respuestael paso es lo bastante rápidomenos de 500 ms
Cuerpo JSONla respuesta contiene los datos correctos$.status es igual a "paid"
Encabezadoel tipo de contenido o la regla de caché correctosContent-Type contiene json
Texto del cuerpoun indicador está presente o ausentecontiene "order created"

Preguntas frecuentes sobre monitorización de API

01¿Qué es la monitorización de API?+
Un servicio automatizado que ejecuta una secuencia real de solicitudes HTTP contra tu API según lo programado y comprueba las respuestas. Un monitor de Uptimia encadena hasta 15 solicitudes y te avisa cuando un paso devuelve el estado incorrecto, los datos incorrectos o tarda demasiado. También la verás llamada monitorización sintética de API o comprobación automatizada del estado de la API.
02¿En qué se diferencia esto de un simple ping de disponibilidad?+
Un ping te dice que el servidor ha respondido. La monitorización de API ejecuta todo el flujo de trabajo y comprueba la propia respuesta — código de estado, tiempo de respuesta, encabezados y los valores del JSON. Un 200 que devuelve datos incorrectos se detecta aquí y es invisible para un simple ping.
03¿Con qué frecuencia ejecuta Uptimia mi comprobación de API?+
Por defecto, cada 5 minutos, y hasta una vez por minuto como máximo — el barrido de programación se ejecuta cada minuto, así que un minuto es el límite mínimo. También puedes ralentizar cualquier monitor para endpoints de menor prioridad.
04¿Cuántos pasos puede tener un monitor?+
Hasta 15 solicitudes HTTP en una sola cadena, cada una con hasta 20 encabezados, 15 aserciones y 10 extracciones de valores. El tiempo de espera por paso va de 1 a 60 segundos, y toda la cadena tiene un límite de ejecución de 90 segundos.
05¿Ejecuta JavaScript o renderiza la página como un navegador?+
No. La monitorización de API envía solicitudes HTTP simples — sin navegador sin interfaz, sin JavaScript, sin capturas de pantalla. Para recorrer un flujo renderizado con un navegador real, usa la monitorización de transacciones de Uptimia; la monitorización de API es la herramienta más ligera y rápida para la propia API.
06¿Puedo comprobar un valor dentro de la respuesta JSON?+
Sí. Apunta un selector JSONPath al campo y comprueba que existe, que es igual, que contiene o que es uno de un conjunto de valores. También puedes extraer un valor en una variable y reutilizarlo en pasos posteriores como {{name}}. El soporte de JSONPath es un subconjunto centrado en las respuestas de API habituales.
07¿Admitís GraphQL o WebSockets?+
GraphQL funciona como una simple solicitud HTTP POST — envía la consulta en el cuerpo y comprueba el JSON que devuelve — pero no hay un creador específico para GraphQL. WebSockets no está soportado; la monitorización de API cubre solicitud/respuesta sobre HTTP (GET, POST, PUT, PATCH, DELETE, HEAD).
08¿Puedo importar un comando cURL o partir de una plantilla?+
No en esta versión. Construyes cada paso en el editor — método, URL, encabezados, cuerpo, aserciones, extracciones — y puedes duplicar un paso para avanzar rápido. La importación de cURL y una biblioteca de plantillas todavía no forman parte de la monitorización de API.
09¿Cómo evitáis las falsas alarmas?+
Una ejecución fallida se vuelve a ejecutar desde otras sondas antes de que se abra un incidente — por defecto, tres sondas deben coincidir (la original más dos repeticiones) antes de que te avisen. La recuperación es rápida en sentido contrario: una sola ejecución correcta cierra el incidente y envía el aviso de recuperación.
10¿Están seguras mis claves de API dentro de una comprobación?+
Sí. Guarda las credenciales como variables secretas: de solo escritura, enmascaradas al leerlas y ocultas en las URLs, encabezados y fragmentos de respuesta que se muestran — nada sensible llega a tu historial de ejecuciones.
11¿Es la monitorización de API un complemento de pago?+
No. Todos los planes incluyen la monitorización de API junto con la de disponibilidad, SSL, transacciones, DNS y heartbeat — nunca como complemento de pago. Incluso el plan gratuito incluye un monitor de API; los planes solo difieren en cuántos incluyen, y la prueba gratuita de 30 días incluye hasta 50, sin necesidad de tarjeta de crédito.

Empieza a monitorizar tu API hoy mismo.

Crea la cadena, pruébala contra el endpoint real — y la próxima vez que un paso falle, la alerta ya te dirá cuál.

Prueba gratuita de 30 días Hasta 50 monitores de API Sin tarjeta de crédito Conforme al RGPD
La monitorización de API se une a la de disponibilidad, SSL, velocidad, transacciones, DNS y heartbeat bajo un único inicio de sesión de Uptimia.