Сначала найдите идентификатор сервиса
Используйте метод 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


