uptimescout
Получить API-ключ

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 либо введите лицензионный ключ на экране подключения. Секрет клиента не требуется.

Подключить UptimeScout

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"
}

Быстрый просмотр

Загружаем сохранённые наблюдения

История сигналов

В каждом интервале показан преобладающий сигнал. При равенстве выбирается последнее из состояний с одинаковым количеством. Нажмите на столбик, чтобы увидеть состав наблюдений.