REST / MCP / SDK
Документация UptimeScout API
Статусы сервисов, региональные сигналы и история через REST, SDK и MCP. Добавляйте данные о доступности в приложения, панели мониторинга и ИИ-ассистенты.
Быстрый старт
curl -G https://api.uptimescout.com/v1/status \ --data-urlencode "service=github" \ --data-urlencode "region=US" \ -H "Authorization: Bearer $EVELODE_LICENSE_KEY"
Доступные методы
GET /v1/servicesПоиск по каталогу сервисов с постраничной выдачей.GET /v1/statusТекущий сохранённый статус одного сервиса.GET /v1/statusesСтатусы нескольких сервисов одним запросом.GET /v1/summaryСводка сигналов по региону или выбранным сервисам.GET /v1/historyИстория сохранённых наблюдений с постраничной выдачей.GET /v1/statsДоли сохранённых сигналов, а не измеренный процент uptime.GET /v1/incidentsСервисы с повышенными сигналами; это не подтверждённые глобальные аварии.Как устроены данные
UptimeScout сохраняет региональные наблюдения в фоновом режиме. Каждый ответ содержит время наблюдения и сведения о его актуальности. Для одного и того же сервиса в разных регионах могут отображаться разные сигналы.
Отсутствие сигнала о сбое означает, что в сохранённом наблюдении не отмечено повышенного сигнала. Повышенные сигналы описывают наблюдаемую ситуацию и не подтверждают глобальную аварию. Отсутствующие и устаревшие наблюдения считаются неизвестными. Доли наблюдений — не измеренный процент uptime и не SLA.
Интерфейс обновляется раз в минуту. Время наблюдения и признак актуальности показывают, насколько свежие данные доступны для конкретного сервиса.
Язык определяет, как представлена информация, а регион наблюдения — к какой стране относятся данные. Эти параметры можно менять независимо. Переведённая страница не означает, что наблюдения автоматически относятся к какой-либо конкретной стране.
Все сервисыЛицензия и лимиты запросов
Передавайте лицензионный ключ Evelode как Bearer-токен. Храните его на сервере, вне браузерного кода и публичных репозиториев. Лимит расходуют только успешные лицензионные запросы к данным. Продление лицензии или смена тарифа запускает новый лимит; календарный месяц его не обнуляет. Годовой тариф предоставляет единый пул запросов на весь годовой срок лицензии.
Оплата, продление, смена тарифа и управление лицензиями — на Evelode.com. Счётчик запросов обнуляется при продлении лицензии или смене её тарифа, а не с наступлением календарного месяца. Годовой тариф включает объём за 12 месяцев единым пакетом на весь срок лицензии. История накапливается с начала сбора. Бесплатный тариф не предусматривает регулярную оплату.
ТарифыПодключение ИИ-ассистента
Добавьте адрес сервера в ассистент, выберите OAuth и войдите через Evelode либо введите лицензионный ключ на экране подключения. Секрет клиента не требуется.
https://mcp.uptimescout.com Authorization: Bearer YOUR_EVELODE_LICENSE_KEY
Обработка ответов
Проверяйте HTTP-статус перед чтением данных: 400 — неверные параметры, 401 или 403 — проблема авторизации или лицензии, 409 — условия лицензии изменились во время запроса, 429 — лимит запросов или частоты, 503 — временная недоступность. Соблюдайте задержку перед повтором и избегайте бесконечных частых повторов.
Пример из сохранённых наблюдений
{
"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.500004Z",
"region": "RU",
"service": {
"age_seconds": 53,
"category": "top",
"description": "\u0411\u0430\u043d\u043a\u043e\u0432\u0441\u043a\u0438\u0439 \u0441\u0435\u0440\u0432\u0438\u0441 \u0434\u043b\u044f \u0441\u0447\u0435\u0442\u043e\u0432, \u043f\u0435\u0440\u0435\u0432\u043e\u0434\u043e\u0432, \u043f\u043b\u0430\u0442\u0435\u0436\u0435\u0439 \u0438 \u0434\u0440\u0443\u0433\u0438\u0445 \u0444\u0438\u043d\u0430\u043d\u0441\u043e\u0432\u044b\u0445 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0439.",
"description_language": "ru",
"id": "sberbank",
"logo_kind": "brand",
"logo_url": "https://uptimescout.com/static/cached-logos/sberbank.svg?v=18e8e8fd2fee71a9",
"name": "\u0421\u0431\u0435\u0440\u0431\u0430\u043d\u043a",
"observed_at": "2026-11-18T18:54:25.110739Z",
"regions": [
"RU"
],
"scope": "regional",
"signal": "reported_availability",
"stale": false,
"status": "operational"
},
"stale_after_seconds": 600,
"status": "ok"
}