uptimescout
Obtener una clave de API

Guía de UptimeScout

Cómo integrar una API de disponibilidad de servicios con UptimeScout

Cree un panel de disponibilidad que mantenga visibles las marcas de tiempo y la incertidumbre, en lugar de reducir cada respuesta a un punto de color.

Conectores de fibra y red en un panel de servidores.
Ilustración editorial generada con IA

Descubra los ID de los servicios antes de consultarlos periódicamente

Empiece por el endpoint de servicios para encontrar el identificador que usa UptimeScout. El nombre de una marca legible para las personas no siempre coincide con el identificador de la API. Guarde el ID y la región en la configuración de su aplicación para que las solicitudes de estado e historial se refieran al mismo servicio.

Adquiera una licencia válida a través de Evelode y guarde la clave de licencia en un gestor de secretos del servidor o en una variable de entorno. No incluya la clave en JavaScript del navegador, un repositorio público, una captura de pantalla ni una URL.

Envíe una solicitud de estado autenticada

Defina EVELODE_LICENSE_KEY en su propio entorno antes de ejecutar el ejemplo. Este ejemplo solicita observaciones de GitHub para US; es una plantilla de solicitud, no una afirmación sobre el estado actual de GitHub.

curl -G https://api.uptimescout.com/v1/status \
  --data-urlencode "service=github" \
  --data-urlencode "region=US" \
  -H "Authorization: Bearer $EVELODE_LICENSE_KEY"

Interprete la respuesta antes de mostrarla

Una respuesta de transporte satisfactoria y la señal de disponibilidad del servicio son capas distintas. Primero, valide el estado HTTP y el sobre de la respuesta. Después, examine service.status, service.observed_at y service.stale. Mantenga visibles los estados unknown y obsoletos en lugar de tratarlos como operational sin indicarlo.

Guarde la región junto con la hora de observación. Si su propia interfaz se actualiza cada minuto, indique por separado la hora de observación y la hora en que su aplicación obtuvo la respuesta. Una respuesta HTTP reciente puede describir una observación anterior.

Planifique el volumen de solicitudes y gestione los límites

Use el estado por lotes si se ajusta a su flujo de trabajo y consulte el tamaño máximo de lote permitido por el plan seleccionado. El límite de solicitudes y las solicitudes por minuto son límites diferentes. El acceso a REST, los SDK y MCP comparte el mismo cómputo de solicitudes de la licencia.

Ante un HTTP 429, respete Retry-After y evite una ráfaga de reintentos inmediatos. Para fallos temporales, use reintentos limitados con intervalos cada vez mayores; no reintente indefinidamente los errores de autenticación ni los de parámetros no válidos. La renovación y los cambios de plan actualizan el límite de la licencia; no se restablece el primer día del mes natural.

Pruebe los casos inciertos antes de implementar

Pruebe un servicio conocido, un ID desconocido, una clave ausente, parámetros no válidos y una observación obsoleta o ausente. Compruebe que estos casos generen mensajes útiles en su interfaz. No incluya resultados de diagnóstico completos en registros públicos si contienen credenciales o información de la cuenta.

La documentación de la API contiene los siete métodos públicos y el esquema OpenAPI. jsonscraper enlaza los SDK de Python, Node.js, PHP, Go, Java y .NET. Una biblioteca de cliente simplifica el transporte, pero su aplicación sigue necesitando una política para interpretar la incertidumbre.

Contenido revisado el 18 de noviembre de 2026.

Markdown

REST / MCP / SDK

Consulte un servicio o integre la API

Use el directorio de servicios para consultar una señal regional actual y la documentación para crear una integración reproducible.

Directorio de serviciosDocumentación de la API