# UptimeScout API: regionalna dostępność usług dla Twoich aplikacji i AI

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

Author: Michael Johnson

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

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

Uruchamiamy API w jsonscraper: REST, MCP i sześć gotowych SDK. Sprawdzaj zależności zewnętrzne z wybranego kraju — zacznij za darmo.

![UptimeScout — Monitorowanie dostępności usług](https://jsonscraper.com/assets/img/uptimescout-launch/cover-v8-pl.webp)

Gdy zewnętrzna platforma przestaje odpowiadać, szybko staje się to Twoim problemem: nie działa autoryzacja, integracja się zawiesza, a kolejka zgłoszeń do pomocy technicznej rośnie. Jednocześnie ta sama usługa może wyglądać inaczej dla użytkowników z różnych krajów. Ogólny status „wszystko działa” to za mało w takiej sytuacji.



Uruchamiamy [UptimeScout API w jsonscraper](https://jsonscraper.com/pl/services/uptimescout-api?region=RU). Udostępnia ono aplikacjom i asystentom AI regionalne sygnały dostępności usług zewnętrznych — wraz z historią, czasem obserwacji i wyraźnym oznaczeniem aktualności danych. Dostępne są już REST, MCP i SDK dla sześciu języków. Zacząć można od bezpłatnego planu.

 

## Sprawdzaj usługę z perspektywy wybranego kraju



Dla zespołu pomocy technicznej ważne jest proste pytanie: co dzieje się z usługą tam, gdzie znajduje się użytkownik? UptimeScout pozwala wybrać kraj, uzyskać bieżący sygnał i porównać go z obserwacjami z innych regionów.



Możesz na przykład sprawdzić GitHub dla Rosji i Niemiec, a następnie otworzyć historię z dostępnego okresu. To uzupełnia własne logi o kontekst i pomaga wybrać kolejny krok dochodzenia. W zweryfikowanej odpowiedzi API z 19 listopada 2026 roku dostępne były 72 regiony. Aktualny zakres sprawdzisz w `available_regions`: może się różnić w zależności od usługi.



Każda odpowiedź zawiera czas obserwacji `observed_at` i oznaczenie nieaktualności `stale`. Język opisu jest wybierany niezależnie od kraju: możesz otrzymywać obserwacje dla Japonii z opisem po polsku lub angielsku. Łącznie obsługiwanych jest 20 języków opisów.



> Sygnał regionalny pomaga zauważyć problem. Nie ustala jego przyczyny ani nie potwierdza globalnej awarii. Podczas dochodzenia porównuj go z własnymi testami i oficjalnym statusem dostawcy; statystyki obserwacji nie są pomiarem uptime ani SLA.

 

## Otwórz mapę obserwacji



Wybierz kraj lub wyszukaj usługę. Przełączaj się między globusem a mapą, aby zobaczyć różnice regionalne i czas ostatnich obserwacji.



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



Mapa pokazuje zapisany obraz danych, aktualizowany w tle mniej więcej raz na minutę. Czas obserwacji jest cały czas widoczny: jeśli brakuje świeżych danych, nie można uznać stanu za potwierdzony.

 

## Od sygnału zewnętrznego do przydatnego działania



Dodaj UptimeScout do procesu, z którego Twój zespół już korzysta. Na pulpicie zapewni kontekst zależności zewnętrznych. W pomocy technicznej pozwoli sprawdzić zgłoszenie z konkretnego kraju. W automatyzacji będzie źródłem danych do własnego raportu lub powiadomienia.



![Ilustracja koncepcyjna: obserwacje regionalne są łączone w uporządkowaną odpowiedź API](https://jsonscraper.com/assets/img/uptimescout-launch/regions-v2.webp)

Kontekst regionalny dla Twoich integracji. Ilustracja koncepcyjna, nie przedstawia rzeczywistych pomiarów.



1. 01
   
   **Wybierz kontekst**
   
   Potrzebną usługę i kraj, w którym znajdują się Twoi odbiorcy.
2. 02
   
   **Sprawdź obserwację**
   
   Status, czas i aktualność danych w jednej odpowiedzi.
3. 03
   
   **Wykorzystaj wynik**
   
   Na pulpicie, w pomocy technicznej lub asystencie AI.



W przypadku kilku zależności skorzystaj z zapytania zbiorczego. Aby porównać kraje, wykonaj osobne zapytanie dla każdego regionu. Zanim wyślesz użytkownikom niepokojące powiadomienie, zweryfikuj sygnał w dodatkowych źródłach.

 

## Jedno API do trzech zadań



### Znajdź usługę



`/v1/services` — wyszukiwanie w katalogu. Zacznij tutaj, aby wybrać potrzebną zależność.



### Sprawdź bieżącą sytuację



`/v1/status` zwraca sygnał dla jednej usługi, `/v1/statuses` — dla kilku naraz, a `/v1/summary` tworzy podsumowanie.



### Sprawdź zmiany



`/v1/history` udostępnia historię, `/v1/stats` — statystyki obserwacji, a `/v1/incidents` — najnowsze podwyższone sygnały problemów.



Wszystkie siedem metod jest dostępnych również przez MCP, na przykład `uptimescout_status` i `uptimescout_history`. Pełne parametry znajdziesz w [specyfikacji OpenAPI](https://uptimescout.com/openapi.json).

 

## Pierwsze zapytanie w kilka minut



Wybierz [bezpłatny plan](https://jsonscraper.com/pl/services/uptimescout-api#pricing), uzyskaj klucz licencyjny przez Evelode i zapisz go na serwerze w zmiennej `UPTIMESCOUT_LICENSE_KEY`. Jeden klucz działa z REST, MCP i wszystkimi 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'
```



Jeśli pracujesz z Python, zainstaluj gotowego klienta z wydania GitHub:



```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"])
```



Oprócz [Python](https://github.com/jsonscraper/uptimescout-api-python) dostępne są SDK dla [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) i [.NET](https://github.com/jsonscraper/uptimescout-api-dotnet). Każde repozytorium zawiera instrukcje i przykładowe zapytania.



Podczas przetwarzania odpowiedzi rozróżniaj dwa pola: najwyższego poziomu `status` opisuje wykonanie zapytania do API, a `service.status` — sygnał wybranej usługi. Przy interpretacji wyniku uwzględnij kraj, czas obserwacji i `stale`.

 

## Co zawiera odpowiedź



Poniżej znajduje się skrócona, rzeczywista odpowiedź UptimeScout dla GitHub w Rosji, uzyskana 19 listopada 2026 roku. To przykład struktury danych, a nie bieżący status usługi; pominięto pola licencji i zużycia limitu.



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`**


Sygnał wybranej usługi; tutaj — operational.



**`region`**


Kraj, w którym dokonano obserwacji, a nie język odpowiedzi.



**`observed_at`**


Data i godzina obserwacji w UTC.



**`stale`**


Informacja, czy obserwacja jest już nieaktualna.



Pole `generated_at` wskazuje czas utworzenia odpowiedzi. Nie zastępuje pola `observed_at`: dane mogą być starsze niż sama odpowiedź.

 

## To samo API — w rozmowie z asystentem



Jeśli wolisz zacząć bez własnego kodu, podłącz `https://mcp.uptimescout.com` do zgodnego klienta AI. [Instrukcja MCP](https://mcp.uptimescout.com/connect?ui_locales=pl) opisuje autoryzację przez Evelode lub klucz licencyjny. Dostępny jest także [wspólny konektor jsonscraper](https://jsonscraper.com/pl/services/uptimescout-api#connect).



> „Sprawdź GitHub w Rosji i Niemczech. Podaj czas obserwacji i aktualność danych dla każdego kraju. Jeśli sygnały się różnią, wyjaśnij, co wiadomo i jakie kontrole warto przeprowadzić dalej”.



Asystent otrzyma uporządkowane dane API i będzie mógł wyjaśnić wynik w kontekście Twojego zadania. Ograniczenia dotyczące aktualności i zasięgu regionalnego nadal obowiązują.

 

## Trzy sposoby korzystania z tych samych danych



Wybierz wygodny interfejs. REST sprawdzi się przy bezpośrednich żądaniach HTTP, SDK — w aplikacji, a MCP — w przypadku asystenta AI. Region, aktualność obserwacji i znaczenie statusów pozostają takie same we wszystkich wariantach.



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

**UptimeScout API**Usługa · kraj · czas obserwacji



- **REST**Bezpośrednie żądania HTTP
- **SDK**Gotowy klient do aplikacji
- **MCP**Narzędzia asystenta AI

 

## Bezpłatny start z jasnymi limitami



Plan Free obejmuje **1 000 udanych zapytań w okresie licencji**, do **60 zapytań na minutę**, do **5 usług w jednym pakiecie** i historię z **7 dni**. Możesz wypróbować REST, SDK i MCP z jedną licencją.



Udane zapytanie zbiorcze w ramach limitu planu zużywa jedno zapytanie. Każda kolejna strona historii jest liczona jako osobne wywołanie. Limit jest powiązany z okresem licencji i resetuje się po jej odnowieniu lub zmianie planu, a nie pierwszego dnia miesiąca. Historia obejmuje tylko okresy, dla których rzeczywiście zbierano obserwacje.



To wystarczy, aby poznać API i zbudować prototyp. W przypadku stałego monitorowania dostosuj częstotliwość zapytań do limitu; przy większym obciążeniu dostępne są plany Starter, Builder, Pro i Scale. Aktualne warunki opublikowano na [stronie planów](https://jsonscraper.com/pl/services/uptimescout-api#pricing).

 

## Zacznij od jednej zależności



Wybierz usługę ważną dla Twojego produktu i kraj, w którym znajdują się Twoi odbiorcy. Sprawdź mapę, wykonaj pierwsze zapytanie i oceń, jak kontekst regionalny może pomóc Twojemu zespołowi. Następnie dodaj historię, inne zależności lub własnego asystenta AI.



**[Otwórz UptimeScout API i zacznij za darmo →](https://jsonscraper.com/pl/services/uptimescout-api?region=RU)**
