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



URL: https://uptimescout.com/ru/blog/availability-api-integration/



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



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



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

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



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



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



```sh

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. Библиотека упрощает запросы, но не заменяет правила интерпретации неопределённости.



## Материалы

https://uptimescout.com/ru/docs/

https://uptimescout.com/ru/methodology/

https://uptimescout.com/ru/contacts/
