# Dokumentace k API UptimeScout

Stavy služeb, regionální signály a historie prostřednictvím REST, SDK a MCP. Vytvářejte přehledy a poskytněte asistentům AI jasný kontext dostupnosti.

URL: https://uptimescout.com/cs/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"
```

## Dostupné metody

- `GET /v1/services`: Vyhledávejte v katalogu služeb a procházejte jeho stránky.

- `GET /v1/status`: Načtěte aktuální uložený stav jedné služby.

- `GET /v1/statuses`: Načtěte stavy více služeb v jednom požadavku.

- `GET /v1/summary`: Shrňte pozorované signály pro region nebo vybrané služby.

- `GET /v1/history`: Načtěte uložená pozorování v čase a procházejte je po stránkách.

- `GET /v1/stats`: Vypočítejte poměry uložených vzorků signálů, nikoli naměřenou dostupnost.

- `GET /v1/incidents`: Zobrazte služby se zvýšenými signály; nejde o potvrzené globální incidenty.

## Jak fungují data

UptimeScout ukládá regionální pozorování na pozadí. Každá odpověď obsahuje čas pozorování a informaci o aktuálnosti. U stejné služby se mohou signály v jednotlivých regionech lišit.

Provozní signál znamená, že ve vzorku uloženém v danou chvíli nebylo pozorováno zvýšené narušení. Signály zvýšeného narušení nebo výpadku popisují pozorovaný stav, nikoli potvrzený globální incident. Chybějící nebo zastaralá pozorování mají neznámý stav. Poměr vzorků není procento naměřené dostupnosti ani SLA.

Rozhraní se obnovuje každou minutu. Podle času pozorování a aktuálnosti u každé služby posuďte, jak čerstvé jsou její údaje.

Jazyk určuje, jak se informace zobrazují; region pozorování určuje, ke které zemi se data vztahují. Tyto volby můžete měnit nezávisle. Přeložená stránka automaticky neznamená, že pozorování pocházejí z určité země.

## Licence a limity požadavků

Použijte licenční klíč Evelode jako token Bearer. Uchovávejte ho na svém serveru, mimo kód v prohlížeči a veřejná úložiště. Do limitu se započítávají pouze úspěšné licencované požadavky na data. Obnovením licence nebo změnou tarifu se limit obnoví; kalendářní měsíce ho neresetují. Roční tarify poskytují jeden společný limit požadavků na celé období platnosti roční licence.

## Připojte AI asistenta

Připojte klienta MCP podporujícího Streamable HTTP ke koncovému bodu níže a zadejte licenční klíč do hlavičky Authorization. Sedm nástrojů pouze pro čtení poskytuje stavy služeb, regionální signály a historii. Platí stejné licenční limity.

https://mcp.uptimescout.com

## Zpracování odpovědí

Před načtením dat zkontrolujte stavový kód HTTP: 400 znamená neplatné parametry, 401 nebo 403 signalizuje problém s ověřením nebo licencí, 409 znamená, že se oprávnění licence během požadavku změnilo, 429 označuje překročení limitu počtu nebo frekvence požadavků a 503 znamená dočasnou nedostupnost. Dodržujte prodlevy před opakováním požadavku a vyhněte se rychlému opakování ve smyčce.

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