# Documentación de la API de UptimeScout

Estado de los servicios, señales regionales e historial mediante REST, SDK y MCP. Crea paneles y ofrece a los asistentes de IA información clara sobre la disponibilidad.

URL: https://uptimescout.com/es/docs/

## REST

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

## Métodos disponibles

- `GET /v1/services`: Busca en el catálogo de servicios y consulta sus páginas.

- `GET /v1/status`: Consulta el estado guardado actual de un servicio.

- `GET /v1/statuses`: Consulta los estados de varios servicios en una sola solicitud.

- `GET /v1/summary`: Resume las señales observadas de una región o de los servicios seleccionados.

- `GET /v1/history`: Consulta las observaciones guardadas a lo largo del tiempo, con paginación.

- `GET /v1/stats`: Calcula las proporciones de las muestras de señales guardadas, no la disponibilidad medida.

- `GET /v1/incidents`: Muestra los servicios con señales elevadas; no son incidentes globales confirmados.

## Cómo funcionan los datos

UptimeScout almacena observaciones regionales en segundo plano. Cada respuesta incluye la hora de observación y datos sobre su vigencia. Un mismo servicio puede mostrar señales distintas en diferentes regiones.

Una señal operativa significa que no se observó una interrupción elevada en esa muestra guardada. Las señales elevadas o de interrupción describen condiciones observadas, no un incidente global confirmado. Las observaciones ausentes o desactualizadas se consideran desconocidas. Las proporciones de las muestras no son porcentajes de disponibilidad medidos ni un SLA.

La interfaz se actualiza cada minuto. Consulta la hora de observación y la vigencia de cada servicio para saber qué tan actuales son sus datos.

El idioma determina cómo se presenta la información; la región de observación determina a qué país corresponden los datos. Puedes cambiarlos de forma independiente. Una página traducida no implica automáticamente que las observaciones correspondan a un país concreto.

## Licencia y límites de solicitudes

Usa tu clave de licencia de Evelode como token Bearer. Guárdala en el servidor, fuera del código del navegador y de los repositorios públicos. Solo las solicitudes de datos autorizadas que se completan correctamente consumen el límite disponible. Renovar una licencia o cambiar de plan inicia un nuevo límite; los meses naturales no lo restablecen. Los planes anuales ofrecen un único conjunto de solicitudes para todo el periodo de la licencia anual.

## Conecta un asistente de IA

Conecta un cliente MCP con HTTP transmisible al endpoint que aparece abajo e incluye tu clave de licencia en el encabezado Authorization. Siete herramientas de solo lectura ofrecen estados de los servicios, señales regionales e historial. Se aplican los mismos límites de licencia.

https://mcp.uptimescout.com

## Gestión de respuestas

Comprueba el estado HTTP antes de leer los datos: 400 indica parámetros no válidos; 401 o 403, un problema de autenticación o de licencia; 409, que los permisos de la licencia cambiaron durante la solicitud; 429, un límite de solicitudes o de frecuencia; y 503, una indisponibilidad temporal. Respeta los tiempos de espera antes de reintentar y evita los reintentos continuos.

OpenAPI: https://uptimescout.com/openapi.json
