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

Статья UptimeScout

Как подключить API доступности сервисов UptimeScout

Соберите панель доступности, которая сохраняет время и неопределённость, а не сводит каждый ответ к цветной точке.

Оптоволоконные и сетевые разъёмы на серверной панели.
Иллюстрация, созданная с помощью ИИ

Сначала найдите идентификатор сервиса

Используйте метод services, чтобы узнать идентификатор UptimeScout. Название бренда не всегда совпадает с ID в API. Храните ID и регион в конфигурации приложения, чтобы статус и история относились к одному объекту.

Получите подходящую лицензию в Evelode и храните ключ в серверном секрете или переменной окружения. Не встраивайте платный ключ в браузерный JavaScript, публичный репозиторий, скриншот или URL.

Выполните запрос с авторизацией

Перед запуском задайте EVELODE_LICENSE_KEY в своей среде. Пример запрашивает наблюдения GitHub для US. Это шаблон запроса, а не утверждение о текущем состоянии GitHub.

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

Разберите ответ перед отображением

Успешный HTTP-ответ и сигнал доступности сервиса — разные уровни. Сначала проверьте код HTTP и оболочку ответа, затем service.status, service.observed_at и service.stale. Показывайте unknown и устаревание явно, не превращая их в operational.

Сохраняйте регион вместе со временем наблюдения. Если ваш интерфейс обновляется раз в минуту, отдельно обозначайте время наблюдения и время получения ответа приложением. Новый HTTP-ответ может описывать более старое наблюдение.

Рассчитайте объём и обрабатывайте ограничения

Когда это подходит сценарию, используйте statuses и учитывайте максимальный размер пакета выбранного тарифа. Общий пакет и частота запросов — разные лимиты. REST, SDK и MCP используют единый учёт лицензии.

При HTTP 429 учитывайте Retry-After и не запускайте шквал повторов. Для временных ошибок задайте ограниченное число повторов с растущей задержкой; ошибки авторизации и параметров не нужно повторять бесконечно. Пакет обновляется при продлении и смене тарифа, без календарного сброса первого числа.

Проверьте неопределённые состояния до запуска

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

В документации описаны семь публичных методов и доступна схема OpenAPI. На jsonscraper есть ссылки на SDK Python, Node.js, PHP, Go, Java и .NET. Библиотека упрощает запросы, но не заменяет правила интерпретации неопределённости.

Содержание проверено 18 ноября 2026 года.

Markdown

REST / MCP / SDK

Проверьте сервис или подключите API

В каталоге доступен текущий региональный сигнал, а в документации — методы API и примеры интеграции.

Каталог сервисовДокументация API