# Cómo leer UptimeScout incidents: una señal de fallo aún no es un incidente confirmado

https://jsonscraper.com/es/blog/leer-uptimescout-senales-fallo-incidente-confirmado

Author: Michael Johnson

Published: 2026-11-22T11:35:42+00:00

Updated: 2026-11-22T11:35:42+00:00

El endpoint ayuda a filtrar señales regionales recientes; la causa y la confirmación requieren una verificación aparte

**¿Se puede anunciar de inmediato que un servicio está sufriendo una interrupción basándose en la respuesta de UptimeScout incidents?** No: este endpoint enumera servicios con señales elevadas de interrupción recientes, y la especificación indica expresamente que no son incidentes confirmados por el proveedor. El resultado práctico es una lista breve de señales que verificar, no una conclusión definitiva sobre la causa de la interrupción.



![Artículo: Cómo leer UptimeScout incidents: una señal de fallo aún no es un incidente confirmado
Resumen: La API de UptimeScout puede devolver una lista de servicios con señales elevadas de interrupción. Explicamos cómo consultarla y comprobar la actualidad de los datos sin convertir una señal de observación en un aviso de fallo oficial.
Función de la imagen: portada: la idea central
Sección: 
Tema visual: Ilustración editorial fotográfica: un mapa impreso de Estados Unidos con un pequeño grupo de marcadores de observación rojos y ámbar sobre una región](https://jsonscraper.com/assets/uploads/journal/2026/11/399257d5705aef451896bd5da1238f90.png.hero.webp)

Las señales regionales requieren verificación© jsonscraper · creado con IA

 

Esta distinción es útil para el ingeniero de guardia y el analista: una alerta automática puede decir «comprueba el servicio X en la región Y» y dejar la confirmación del hecho y la explicación de la causa en manos del estado oficial del proveedor o de un diagnóstico propio. La [especificación de UptimeScout](https://uptimescout.com/openapi.json) documenta rutas independientes para señales, estado actual e historial de observaciones.

 

## Qué devuelve exactamente la lista de señales

 

`/v1/incidents` es un endpoint GET del catálogo de servicios con señales elevadas de interrupción. Sus parámetros incluyen filtros por servicio, región, categoría, consulta de búsqueda y ventana temporal. La respuesta requiere una licencia; la API describe la autenticación mediante un token Bearer. El campo de región acepta un código de dos letras, y `hours` define una ventana de entre 1 y 2160 horas.

 

Es fácil interpretar la palabra «incident» de la ruta como «interrupción confirmada», pero la documentación le da un significado más limitado: una señal reciente de observación. Por eso conviene formular las notificaciones de acuerdo con los datos de la respuesta —por ejemplo, «se ha recibido una señal de problemas de disponibilidad»— y no atribuir al proveedor del servicio el reconocimiento de un incidente.

 

## Comprobaciones mínimas antes de notificar

 

Primero, guarda la respuesta original junto con la hora de recepción y los parámetros de la consulta. Después, comprueba qué servicio y región aparecen y evalúa la actualidad mediante los campos del servicio `observed_at` y `stale`. Si la observación está marcada como obsoleta, debe distinguirse de una señal actual, en lugar de presentarse como el estado «en este momento».

 

```
curl -sS 'https://api.uptimescout.com/v1/incidents?region=US&hours=24' \
  -H "Authorization: Bearer $UPTIMESCOUT_LICENSE_KEY"
```

 

Este ejemplo consulta Estados Unidos para una ventana de 24 horas; la clave se lee desde una variable de entorno y no se muestra en la línea de comandos. Tras recibir la respuesta, comprueba los errores HTTP y la estructura JSON, y procesa por separado cada servicio devuelto. Los valores de estado del esquema incluyen `operational`, `degraded`, `outage` y `unknown`; si falta un campo o un valor, no impongas una interpretación propia.

 

Para una señal que requiera actuar, consulta el estado actual del servicio correspondiente mediante `/v1/status` y el historial mediante `/v1/history`. En el historial, es útil guardar junto a las series `resolution_seconds`, `samples`, `counts` y `effective_start`: así, el analista puede ver con qué resolución temporal se recopilaron los datos y qué intervalo efectivo está disponible. La especificación advierte que los intervalos ausentes son desconocidos; un intervalo vacío no debe considerarse automáticamente ni disponibilidad ni interrupción.

 

## Cómo convertir la respuesta en un informe verificable

 

Para cada registro, crea campos para el identificador y el nombre del servicio, la región consultada, el estado, la hora de observación, el indicador de obsolescencia, la hora de recepción de la respuesta y un enlace a la fuente del estado oficial, si el equipo lo ha comprobado. Este último campo lo completa tu integración o un operador: la especificación de UptimeScout no garantiza que la señal incluya una causa confirmada o una declaración del proveedor.



![Artículo: Cómo leer UptimeScout incidents: una señal de fallo aún no es un incidente confirmado
Resumen: La API de UptimeScout puede devolver una lista de servicios con señales elevadas de interrupción. Explicamos cómo consultarla y comprobar la actualidad de los datos sin convertir una señal de observación en un aviso de fallo oficial.
Función de la imagen: ilustración complementaria 2: un aspecto específico diferente
Sección: Cómo convertir la respuesta en un informe verificable
Tema visual: Infografía editorial en ruso que muestra un proceso sencillo de tres etapas](https://jsonscraper.com/assets/uploads/journal/2026/11/985141e25ed6bf354030f6e87e5e10fc.png.hero.webp)

De la señal a una conclusión verificada© jsonscraper · ilustración generada con IA

 

Divide el flujo de trabajo en tres estados. «Señal recibida» significa que el registro apareció en el resultado de `/v1/incidents`. «Estado en verificación» significa que has consultado el estado actual y el historial. Reserva «Confirmado» para una conclusión respaldada por un comunicado oficial externo o por una verificación interna. Esta sencilla distinción evita que el panel presente una señal agregada como un hecho establecido.

 

Si el equipo prepara un informe para varias regiones, realiza consultas independientes con los códigos regionales necesarios y guarda el parámetro junto con el resultado. El campo `lang` corresponde al idioma de las descripciones de los servicios; no cambia la región de observación. Esta distinción importa, por ejemplo, al comparar un catálogo localizado con el estado regional.

 

## Hasta dónde llegan las conclusiones

 

El resultado verificable de este flujo es un registro de señales con marcas explícitas de hora, región y actualidad, complementado con una verificación independiente del estado y del historial. Ayuda a detectar qué requiere atención y qué se ha podido confirmar a partir de las fuentes seleccionadas. La respuesta de `/v1/incidents` informa de una señal elevada de observación; para anunciar una interrupción confirmada se necesitan datos que la corroboren.
