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

Статуси сервісів, регіональні сигнали та історія через REST, SDK і MCP. Створюйте дашборди й надавайте ШІ-асистентам зрозумілий контекст доступності.

URL: https://uptimescout.com/uk/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`: Обчислюйте частки спостережень за сигналами, а не виміряний час безперебійної роботи.

- `GET /v1/incidents`: Переглядайте сервіси з підвищеними сигналами; це не підтверджені глобальні інциденти.

## Як працюють дані

UptimeScout зберігає регіональні спостереження у фоновому режимі. Кожна відповідь містить час спостереження та інформацію про актуальність даних. Для того самого сервісу в різних регіонах сигнали можуть відрізнятися.

Операційний сигнал означає, що в збереженому зразку не зафіксовано підвищеного рівня перебоїв. Сигнали про підвищений рівень перебоїв або збої описують спостережувані умови, а не підтверджений глобальний інцидент. Відсутні або застарілі спостереження вважаються невідомими. Частка вибірок — це не виміряний відсоток часу безперебійної роботи й не SLA.

Інтерфейс оновлюється щохвилини. Перевіряйте час спостереження та актуальність даних для кожного сервісу, щоб оцінити, наскільки свіжий його статус.

Мова визначає, якою мовою подано інформацію, а регіон спостереження — якої країни стосуються дані. Їх можна змінювати незалежно. Перекладена сторінка автоматично не означає, що спостереження стосуються певної країни.

## Ліцензія та ліміти запитів

Використовуйте ліцензійний ключ Evelode як Bearer-токен. Зберігайте його на сервері, а не в коді браузера чи публічних репозиторіях. Ліміт зменшують лише успішні запити до ліцензованих даних. Поновлення ліцензії або зміна плану встановлює новий ліміт; початок календарного місяця його не скидає. Річні плани надають єдиний пул запитів на весь термін річної ліцензії.

## Підключіть AI-асистента

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

https://mcp.uptimescout.com

## Обробка відповідей

Перш ніж читати дані, перевірте HTTP-статус: 400 означає некоректні параметри, 401 або 403 — проблему автентифікації чи ліцензії, 409 — зміну прав за ліцензією під час запиту, 429 — перевищення ліміту запитів або частоти, а 503 — тимчасову недоступність. Дотримуйтеся затримок перед повторними спробами й уникайте частих повторів без пауз.

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