Lze z odpovědi UptimeScout incidents rovnou vyhlásit, že služba má výpadek? Ne: tento endpoint uvádí služby s nedávnými zvýšenými signály narušení a specifikace výslovně upozorňuje, že nejde o poskytovatelem potvrzené incidenty. Praktickým výsledkem je krátký seznam signálů k prověření, nikoli hotový závěr o příčině výpadku.

Pro pohotovostního inženýra a analytika je tento rozdíl důležitý: automatické upozornění může sdělit „prověřte službu X v regionu Y“, zatímco potvrzení skutečnosti a vysvětlení příčiny ponechá oficiálnímu stavu poskytovatele nebo vlastní diagnostice. Specifikace UptimeScout dokumentuje samostatné trasy pro signály, aktuální stav a historii pozorování.
Co přesně seznam signálů vrací
/v1/incidents je GET endpoint katalogu služeb se zvýšenými signály narušení. Mezi jeho parametry patří filtry podle služby, regionu, kategorie, vyhledávacího dotazu a časového okna. Odpověď vyžaduje licenci; API popisuje autorizaci pomocí tokenu Bearer. Pole regionu přijímá dvoupísmenný kód a hours určuje časové okno od 1 do 2160 hodin.
Slovo „incident“ v cestě lze snadno chápat jako „potvrzenou havárii“, dokumentace mu však přisuzuje užší význam: čerstvý signál z pozorování. Upozornění proto formulujte podle údajů v odpovědi, například „obdržen signál o narušení dostupnosti“, a nepřipisujte poskytovateli služby potvrzení incidentu.
Minimální kontrola před upozorněním
Nejprve uložte původní odpověď spolu s časem přijetí a parametry dotazu. Poté ověřte, která služba a region se vrátily, a posuďte aktuálnost podle polí služby observed_at a stale. Pokud je pozorování označeno jako zastaralé, oddělte ho od aktuálního signálu a nezobrazujte ho jako stav „právě teď“.
curl -sS 'https://api.uptimescout.com/v1/incidents?region=US&hours=24' \
-H "Authorization: Bearer $UPTIMESCOUT_LICENSE_KEY"
Jde o příklad dotazu pro USA s časovým oknem 24 hodin; klíč se načítá z proměnné prostředí a nezobrazuje se v příkazovém řádku. Po obdržení odpovědi zkontrolujte chyby HTTP a strukturu JSON, poté zpracujte každou vrácenou službu zvlášť. Hodnoty stavu ve schématu zahrnují operational, degraded, outage a unknown; pokud pole nebo hodnota chybí, nedoplňujte vlastní interpretaci.
U signálu, který vyžaduje zásah, si vyžádejte aktuální stav příslušné služby přes /v1/status a historii přes /v1/history. V historii je užitečné ukládat spolu s časovými řadami také resolution_seconds, samples, counts a effective_start: analytik tak vidí časové rozlišení použitých dat i skutečný interval, za který jsou dostupná. Specifikace upozorňuje, že chybějící intervaly nejsou známy; prázdnou mezeru nelze automaticky považovat ani za dostupnost, ani za výpadek.
Jak z odpovědi vytvořit ověřitelnou zprávu
Pro každý záznam uložte tato pole: identifikátor a název služby, region dotazu, stav, čas pozorování, příznak zastarání, čas přijetí odpovědi a odkaz na zdroj oficiálního stavu, pokud jej tým ověřil. Poslední pole doplňuje vaše integrace nebo operátor: specifikace UptimeScout neslibuje, že signál obsahuje potvrzenou příčinu nebo vyjádření poskytovatele.

Pracovní postup rozdělte do tří stavů. „Signál přijat“ znamená, že se záznam objevil ve výsledku /v1/incidents. „Probíhá ověření stavu“ znamená, že jste si vyžádali aktuální stav a historii. Stav „potvrzeno“ ponechte pro závěr podložený oficiálním externím sdělením nebo interním ověřením. Toto jednoduché rozdělení zabrání tomu, aby dashboard vydával agregovaný signál za prokázanou skutečnost.
Pokud tým vytváří zprávu pro několik regionů, provádějte samostatné dotazy s příslušnými kódy regionů a ukládejte parametr spolu s výsledkem. Pole lang se týká jazyka popisů služeb; region pozorování nemění. Toto rozlišení je důležité například při porovnávání lokalizovaného katalogu a regionálního stavu.
Kde končí závěr
Ověřitelným výsledkem tohoto postupu je protokol signálů s výslovně uvedenými časovými údaji, regionem a aktuálností, doplněný samostatným ověřením stavu a historie. Pomáhá zjistit, čemu je třeba věnovat pozornost a co se podařilo ověřit z vybraných zdrojů. Samotná odpověď /v1/incidents informuje o zvýšeném signálu z pozorování; k vyhlášení potvrzeného výpadku jsou zapotřebí podpůrné údaje.