REST / MCP / SDK
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.
Guía de inicio rápido
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/servicesBusca en el catálogo de servicios y consulta sus páginas.GET /v1/statusConsulta el estado guardado actual de un servicio.GET /v1/statusesConsulta los estados de varios servicios en una sola solicitud.GET /v1/summaryResume las señales observadas de una región o de los servicios seleccionados.GET /v1/historyConsulta las observaciones guardadas a lo largo del tiempo, con paginación.GET /v1/statsCalcula las proporciones de las muestras de señales guardadas, no la disponibilidad medida.GET /v1/incidentsMuestra 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.
Todos los serviciosLicencia 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.
Evelode.com gestiona los pagos, las renovaciones, los cambios de plan y la administración de licencias. La cuota de solicitudes se restablece al renovar la licencia o cambiar de plan. No se restablece al comienzo de cada mes natural. Los planes anuales incluyen doce cuotas mensuales en una sola bolsa de solicitudes para todo el período de vigencia de la licencia. El historial se acumula desde el inicio de la recopilación. El plan Free no tiene cargos recurrentes.
PreciosConecta un asistente de IA
Añade la URL del servidor a tu asistente, selecciona OAuth e inicia sesión con Evelode o introduce tu clave de licencia en la pantalla de conexión. No se necesita un secreto de cliente.
https://mcp.uptimescout.com Authorization: Bearer YOUR_EVELODE_LICENSE_KEY
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.
Ejemplo de observaciones guardadas
{
"available_regions": [
"AE",
"AR",
"AT",
"AU",
"AZ",
"BD",
"BE",
"BG",
"BH",
"BR",
"CA",
"CH",
"CL",
"CO",
"CR",
"CZ",
"DE",
"DK",
"DO",
"DZ",
"EC",
"EG",
"ES",
"FI",
"FR",
"GB",
"GR",
"GT",
"HK",
"HR",
"HU",
"ID",
"IE",
"IL",
"IN",
"IT",
"JO",
"JP",
"KE",
"KR",
"MA",
"MX",
"MY",
"NG",
"NL",
"NO",
"NZ",
"PA",
"PE",
"PH",
"PK",
"PL",
"PR",
"PT",
"PY",
"RO",
"RS",
"RU",
"SA",
"SE",
"SG",
"SK",
"TH",
"TN",
"TR",
"TW",
"UA",
"US",
"UY",
"VE",
"VN",
"ZA"
],
"data_type": "availability_observations",
"generated_at": "2026-11-18T18:55:18.272077Z",
"region": "US",
"service": {
"age_seconds": 16,
"category": "it",
"description": "Plataforma para repositorios Git, colaboraci\u00f3n en c\u00f3digo, incidencias y entrega de software.",
"description_language": "es",
"id": "github",
"logo_kind": "brand",
"logo_url": "https://uptimescout.com/static/brand-assets/github.svg?v=18e8fe76f953a31c",
"name": "GitHub",
"observed_at": "2026-11-18T18:55:01.987427Z",
"regions": [
"US"
],
"scope": "regional",
"signal": "reported_availability",
"stale": false,
"status": "outage"
},
"stale_after_seconds": 600,
"status": "ok"
}