uptimescout
Získat klíč API

REST / MCP / SDK

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.

Rychlý start

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/servicesVyhledávejte v katalogu služeb a procházejte jeho stránky.
GET /v1/statusNačtěte aktuální uložený stav jedné služby.
GET /v1/statusesNačtěte stavy více služeb v jednom požadavku.
GET /v1/summaryShrňte pozorované signály pro region nebo vybrané služby.
GET /v1/historyNačtěte uložená pozorování v čase a procházejte je po stránkách.
GET /v1/statsVypočítejte poměry uložených vzorků signálů, nikoli naměřenou dostupnost.
GET /v1/incidentsZobrazte 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ě.

Všechny služby

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.

Platby, obnovování, změny tarifů a správa licencí probíhají na Evelode.com. Limit požadavků se obnoví při obnovení licence nebo změně tarifu. Na začátku kalendářního měsíce se neobnovuje. Roční tarify zahrnují dvanáct měsíčních limitů jako jeden společný limit na celé období platnosti licence. Historie se shromažďuje od spuštění sběru. Tarif Free se neúčtuje opakovaně.

Ceník

Připojte AI asistenta

Přidejte adresu serveru do asistenta, vyberte OAuth a přihlaste se přes Evelode nebo zadejte licenční klíč na obrazovce připojení. Tajný klíč klienta není potřeba.

Připojit UptimeScout

https://mcp.uptimescout.com
Authorization: Bearer YOUR_EVELODE_LICENSE_KEY

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.

Příklad z uložených pozorování

{
  "available_regions": [
    "AE",
    "AR",
    "AT",
    "AU",
    "AZ",
    "BD",
    "BE",
    "BG",
    "BH",
    "BR",
    "CA",
    "CH",
    "CL",
    "CO",
    "CR",
    "CZ",
    "DE",
    "DK",
    "DO",
    "DZ",
    "EC",
    "EG",
    "ES",
    "FI",
    "FR",
    "GB",
    "GR",
    "GT",
    "HK",
    "HR",
    "HU",
    "ID",
    "IE",
    "IL",
    "IN",
    "IT",
    "JO",
    "JP",
    "KE",
    "KR",
    "MA",
    "MX",
    "MY",
    "NG",
    "NL",
    "NO",
    "NZ",
    "PA",
    "PE",
    "PH",
    "PK",
    "PL",
    "PR",
    "PT",
    "PY",
    "RO",
    "RS",
    "RU",
    "SA",
    "SE",
    "SG",
    "SK",
    "TH",
    "TN",
    "TR",
    "TW",
    "UA",
    "US",
    "UY",
    "VE",
    "VN",
    "ZA"
  ],
  "data_type": "availability_observations",
  "generated_at": "2026-11-18T18:55:14.608378Z",
  "region": "US",
  "service": {
    "age_seconds": 12,
    "category": "it",
    "description": "Platforma pro repozit\u00e1\u0159e Git, spolupr\u00e1ci na k\u00f3du, spr\u00e1vu probl\u00e9m\u016f a dod\u00e1v\u00e1n\u00ed softwaru.",
    "description_language": "cs",
    "id": "github",
    "logo_kind": "brand",
    "logo_url": "https://uptimescout.com/static/brand-assets/github.svg?v=18e8fe76f953a31c",
    "name": "GitHub",
    "observed_at": "2026-11-18T18:55:01.987427Z",
    "regions": [
      "US"
    ],
    "scope": "regional",
    "signal": "reported_availability",
    "stale": false,
    "status": "outage"
  },
  "stale_after_seconds": 600,
  "status": "ok"
}

Rychlý přehled

Načítání uložených pozorování

Vývoj signálů v čase

Každý interval zobrazuje nejčastěji pozorovaný signál. Při shodě rozhoduje nejnovější z vyrovnaných stavů. Výběrem sloupce zobrazíte úplný přehled.