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. 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.
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.

- Wybierz kontekst
Potrzebną usługę i kraj, w którym znajdują się Twoi odbiorcy.
- Sprawdź obserwację
Status, czas i aktualność danych w jednej odpowiedzi.
- 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.
Pierwsze zapytanie w kilka minut
Wybierz bezpłatny plan, 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.
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:
python -m pip install "git+https://github.com/jsonscraper/[email protected]"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 dostępne są SDK dla Node.js, PHP, Go, Java i .NET. 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.
{
"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 opisuje autoryzację przez Evelode lub klucz licencyjny. Dostępny jest także wspólny konektor jsonscraper.
„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.
- RESTBezpośrednie żądania HTTP
- SDKGotowy klient do aplikacji
- MCPNarzę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.
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.
