# UptimeScout API: regionální dostupnost služeb pro vaše aplikace a AI

https://jsonscraper.com/cs/blog/uptimescout-api-regional-monitoring-launch

Author: Michael Johnson

Published: 2026-11-19T15:24:18+00:00

Updated: 2026-11-19T15:24:18+00:00

Spouštíme API na jsonscraper: REST, MCP a šest hotových SDK. Sledujte externí závislosti z požadované země — začněte zdarma.

![UptimeScout — Monitorování dostupnosti služeb](https://jsonscraper.com/assets/img/uptimescout-launch/cover-v8-cs.webp)

Když externí platforma přestane odpovídat, rychle se z toho stane váš problém: nefunguje autorizace, integrace se zasekne a přibývá požadavků na podporu. Přitom může stejná služba vypadat odlišně pro uživatele v různých zemích. Obecné hlášení „všechno funguje“ v takové situaci nestačí.



Spouštíme [UptimeScout API na jsonscraper](https://jsonscraper.com/cs/services/uptimescout-api?region=RU). Vašim aplikacím a AI asistentům poskytuje regionální signály dostupnosti externích služeb — včetně historie, času pozorování a výslovného označení aktuálnosti dat. K dispozici jsou REST, MCP a SDK pro šest jazyků. Začít můžete s bezplatným tarifem.

 

## Sledujte službu z požadované země



Pro tým podpory je důležitá jednoduchá otázka: co se děje se službou tam, kde se nachází uživatel? UptimeScout umožňuje vybrat zemi, získat aktuální signál a porovnat jej s pozorováními z jiných regionů.



Můžete například zkontrolovat GitHub pro Rusko a Německo a potom otevřít historii za dostupné období. Získáte tak další kontext ke svým vlastním protokolům a snáze zvolíte další krok při šetření. V ověřené odpovědi API z 19. listopadu 2026 bylo dostupných 72 regionů. Aktuální pokrytí zjistíte v `available_regions`: u různých služeb se může lišit.



Každá odpověď obsahuje čas pozorování `observed_at` a příznak zastaralosti `stale`. Jazyk popisu se vybírá nezávisle na zemi: můžete získat pozorování pro Japonsko s popisem v ruštině nebo angličtině. Celkem je podporováno 20 jazyků popisu.



> Regionální signál pomáhá odhalit problém. Neurčuje jeho příčinu ani nepotvrzuje globální výpadek. Při šetření jej porovnávejte s vlastními kontrolami a oficiálním stavem poskytovatele; statistiky pozorování nejsou měřením dostupnosti (uptime) ani SLA.

 

## Otevřete mapu pozorování



Vyberte zemi nebo vyhledejte požadovanou službu. Přepínejte mezi glóbem a mapou, abyste viděli regionální rozdíly a čas posledních pozorování.



[Interactive regional observations](https://jsonscraper.com/services/uptimescout-api#regions). Live observations are separate from the historical examples in this article.



Mapa zobrazuje uložený snímek dat, který se na pozadí aktualizuje přibližně jednou za minutu. Čas pozorování zůstává viditelný: pokud nejsou k dispozici aktuální data, stav nelze považovat za potvrzený.

 

## Od externího signálu k užitečné akci



Přidejte UptimeScout do procesu, který váš tým už používá. Na dashboardu poskytne kontext externích závislostí. Podpoře pomůže ověřit hlášení z konkrétní země. V automatizaci se stane zdrojem dat pro vlastní zprávu nebo upozornění.



![Koncepční ilustrace: regionální pozorování se spojují do strukturované odpovědi API](https://jsonscraper.com/assets/img/uptimescout-launch/regions-v2.webp)

Regionální kontext pro vaše integrace. Koncepční ilustrace, nikoli skutečná měření.



1. 01
   
   **Vyberte kontext**
   
   Požadovanou službu a zemi, ve které jsou vaši uživatelé.
2. 02
   
   **Ověřte pozorování**
   
   Stav, čas a aktuálnost dat v jedné odpovědi.
3. 03
   
   **Využijte výsledek**
   
   V dashboardu, podpoře nebo AI asistentovi.



Pro více závislostí použijte dávkový požadavek. Chcete-li porovnat země, odešlete samostatný požadavek pro každý region. Než uživatelům pošlete znepokojivé upozornění, ověřte signál z dalších zdrojů.

 

## Jedno API pro tři úkoly



### Najít službu



`/v1/services` — vyhledávání v katalogu. Začněte zde a vyberte požadovanou závislost.



### Zjistit aktuální stav



`/v1/status` vrací signál pro jednu službu, `/v1/statuses` — pro několik služeb najednou a `/v1/summary` sestaví souhrn.



### Prohlédnout si změny



`/v1/history` poskytuje historii, `/v1/stats` — statistiky pozorování a `/v1/incidents` — nejnovější zvýšené signály problémů.



Všech sedm metod je dostupných také přes MCP, například `uptimescout_status` a `uptimescout_history`. Úplné parametry najdete ve [specifikaci OpenAPI](https://uptimescout.com/openapi.json).

 

## První požadavek za pár minut



Vyberte si [bezplatný tarif](https://jsonscraper.com/cs/services/uptimescout-api#pricing), získejte licenční klíč prostřednictvím Evelode a uložte jej na serveru do proměnné `UPTIMESCOUT_LICENSE_KEY`. Jeden klíč funguje pro REST, MCP i všechna SDK UptimeScout.



```bash
curl --get 'https://api.uptimescout.com/v1/status' \
  --header "Authorization: Bearer $UPTIMESCOUT_LICENSE_KEY" \
  --data-urlencode 'service=github' \
  --data-urlencode 'region=RU' \
  --data-urlencode 'lang=ru'
```



Pokud pracujete s Pythonem, nainstalujte hotového klienta z vydání na GitHubu:



```bash
python -m pip install "git+https://github.com/jsonscraper/uptimescout-api-python.git@0.1.3"
```



```python
import os
from uptimescout import Client

client = Client(os.environ["UPTIMESCOUT_LICENSE_KEY"], timeout=30)
response = client.status("github", region="RU", lang="ru")
service = response["service"]
print(service["status"], service["observed_at"], service["stale"])
```



Kromě [Pythonu](https://github.com/jsonscraper/uptimescout-api-python) jsou k dispozici SDK pro [Node.js](https://github.com/jsonscraper/uptimescout-api-node), [PHP](https://github.com/jsonscraper/uptimescout-api-php), [Go](https://github.com/jsonscraper/uptimescout-api-go), [Java](https://github.com/jsonscraper/uptimescout-api-java) a [.NET](https://github.com/jsonscraper/uptimescout-api-dotnet). Každé úložiště obsahuje pokyny a příklady požadavků.



Při zpracování odpovědi rozlišujte dvě pole: nejvyšší úroveň `status` popisuje provedení požadavku na API, zatímco `service.status` je signál pro vybranou službu. Při interpretaci výsledku zohledněte zemi, čas pozorování a příznak `stale`.

 

## Co obsahuje odpověď



Níže je zkrácená skutečná odpověď UptimeScout pro GitHub v Rusku, získaná 19. listopadu 2026. Jde o příklad struktury dat, nikoli o aktuální stav služby; pole licence a spotřeby kvóty jsou vynechána.



GET /v1/statusJSON · RU



```json
{
  "status": "ok",
  "region": "RU",
  "service": {
    "id": "github",
    "name": "GitHub",
    "status": "operational",
    "stale": false,
    "observed_at": "2026-11-19T13:46:49.188257Z",
    "signal": "reported_availability",
    "scope": "regional"
  },
  "generated_at": "2026-11-19T13:48:48.782598Z",
  "stale_after_seconds": 600
}
```



**`service.status`**


Signál vybrané služby; zde operational.



**`region`**


Země sledování, nikoli jazyk odpovědi.



**`observed_at`**


Čas samotného pozorování v UTC.



**`stale`**


Označuje, zda je pozorování již zastaralé.



Pole `generated_at` udává čas vytvoření odpovědi. Nenahrazuje `observed_at`: data mohou být starší než samotná odpověď.

 

## Stejné API v konverzaci s asistentem



Pokud chcete začít bez vlastního kódu, připojte `https://mcp.uptimescout.com` ke kompatibilnímu AI klientovi. [Pokyny k MCP](https://mcp.uptimescout.com/connect?ui_locales=cs) popisují autorizaci přes Evelode nebo licenční klíč. K dispozici je také [univerzální konektor jsonscraper](https://jsonscraper.com/cs/services/uptimescout-api#connect).



> „Zkontroluj GitHub v Rusku a Německu. U každé země uveď čas pozorování a aktuálnost dat. Pokud se signály liší, vysvětli, co je známo a jaké kontroly bych měl provést dál.“



Asistent získá strukturovaná data z API a vysvětlí výsledek v kontextu vašeho úkolu. Omezení aktuálnosti a regionálního pokrytí přitom zůstávají v platnosti.

 

## Tři způsoby, jak připojit stejná data



Vyberte si rozhraní, které vám vyhovuje. REST se hodí pro přímé požadavky HTTP, SDK pro aplikaci a MCP pro AI asistenta. Region, aktuálnost pozorování i význam stavů zůstávají ve všech případech stejné.



![UptimeScout](https://jsonscraper.com/assets/img/uptimescout-launch/uptimescout-logo.svg)

**UptimeScout API**Služba · země · čas pozorování



- **REST**Přímé požadavky HTTP
- **SDK**Hotový klient pro aplikaci
- **MCP**Nástroje AI asistenta

 

## Bezplatný začátek s jasnými limity



Tarif Free zahrnuje **1 000 úspěšných požadavků za licenční období**, až **60 požadavků za minutu**, až **5 služeb v jedné dávce** a historii za **7 dní**. REST, SDK i MCP můžete vyzkoušet s jedinou licencí.



Úspěšná dávka v rámci limitu tarifu spotřebuje jeden požadavek. Každá další stránka historie se počítá jako samostatné volání. Kvóta je vázána na licenční období a obnoví se při prodloužení nebo změně tarifu, nikoli prvního dne v měsíci. Historie zahrnuje pouze období, za která se skutečně sbírala pozorování.



To stačí k seznámení s API a vytvoření prototypu. Při trvalém monitorování slaďte frekvenci požadavků s kvótou; pro větší zátěž jsou k dispozici tarify Starter, Builder, Pro a Scale. Aktuální podmínky najdete na [stránce tarifů](https://jsonscraper.com/cs/services/uptimescout-api#pricing).

 

## Začněte s jednou závislostí



Vyberte službu, která je pro váš produkt důležitá, a zemi, kde se nachází vaše publikum. Podívejte se na mapu, proveďte první požadavek a zjistěte, jak může regionální kontext vašemu týmu pomoci. Potom přidejte historii, další závislosti nebo vlastního AI asistenta.



**[Otevřít UptimeScout API a začít zdarma →](https://jsonscraper.com/cs/services/uptimescout-api?region=RU)**
