# Документация UptimeScout API

Статусы сервисов, региональные сигналы и история через REST, SDK и MCP. Добавляйте данные о доступности в приложения, панели мониторинга и ИИ-ассистенты.

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

## REST

```sh
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-токен. Храните его на сервере, вне браузерного кода и публичных репозиториев. Лимит расходуют только успешные лицензионные запросы к данным. Продление лицензии или смена тарифа запускает новый лимит; календарный месяц его не обнуляет. Годовой тариф предоставляет единый пул запросов на весь годовой срок лицензии.

## Подключение ИИ-ассистента

Подключите MCP-клиент с поддержкой Streamable HTTP к адресу ниже и передайте лицензионный ключ в заголовке Authorization. Семь инструментов только для чтения возвращают статусы сервисов, региональные сигналы и историю. Действуют те же лицензионные лимиты.

https://mcp.uptimescout.com

## Обработка ответов

Проверяйте HTTP-статус перед чтением данных: 400 — неверные параметры, 401 или 403 — проблема авторизации или лицензии, 409 — условия лицензии изменились во время запроса, 429 — лимит запросов или частоты, 503 — временная недоступность. Соблюдайте задержку перед повтором и избегайте бесконечных частых повторов.

OpenAPI: https://uptimescout.com/openapi.json
