REST / MCP / SDK
Dokumentacja API UptimeScout
Statusy usług, sygnały regionalne i historia dostępne przez REST, SDK i MCP. Twórz pulpity i dostarczaj asystentom AI jasne informacje o dostępności.
Szybki start
curl -G https://api.uptimescout.com/v1/status \ --data-urlencode "service=github" \ --data-urlencode "region=US" \ -H "Authorization: Bearer $EVELODE_LICENSE_KEY"
Dostępne metody
GET /v1/servicesWyszukuj usługi w katalogu i przeglądaj go strona po stronie.GET /v1/statusOdczytuj aktualny zapisany status jednej usługi.GET /v1/statusesOdczytuj statusy wielu usług w jednym żądaniu.GET /v1/summaryPodsumowuj zaobserwowane sygnały dla regionu lub wybranych usług.GET /v1/historyOdczytuj zapisane obserwacje z różnych okresów i przeglądaj je strona po stronie.GET /v1/statsObliczaj proporcje zapisanych próbek sygnałów, a nie zmierzoną dostępność.GET /v1/incidentsWyświetlaj usługi z podwyższonym poziomem zakłóceń; nie są to potwierdzone incydenty globalne.Jak działają dane
UptimeScout gromadzi w tle obserwacje regionalne. Każda odpowiedź zawiera czas obserwacji i informację o jej aktualności. Ta sama usługa może mieć różne sygnały w różnych regionach.
Sygnał prawidłowego działania oznacza, że w zapisanej próbce nie zaobserwowano nasilonych zakłóceń. Sygnały podwyższonego poziomu zakłóceń lub awarii opisują zaobserwowane warunki, a nie potwierdzony incydent globalny. Brakujące lub nieaktualne obserwacje mają status nieznany. Udziały próbek nie są procentowymi wskaźnikami dostępności ani umową SLA.
Interfejs odświeża się co minutę. Sprawdź czas obserwacji i aktualność danych dla każdej usługi, aby ocenić, jak aktualny jest jej status.
Język określa sposób prezentacji informacji, a region obserwacji — kraju, którego dotyczą dane. Możesz zmieniać je niezależnie. Przetłumaczona strona nie oznacza automatycznie, że obserwacje pochodzą z konkretnego kraju.
Wszystkie usługiLicencja i limity żądań
Użyj klucza licencyjnego Evelode jako tokenu Bearer. Przechowuj go na serwerze, poza kodem przeglądarki i publicznymi repozytoriami. Limit pomniejszają tylko udane żądania dotyczące danych, wymagające licencji. Odnowienie licencji lub zmiana jej planu rozpoczyna nowy okres limitu; miesiące kalendarzowe nie powodują jego odnowienia. Plany roczne zapewniają pulę równą 12 miesięcznym pulom zapytań, dostępną przez cały okres rocznej licencji.
Płatności, odnowienia, zmiany planu i zarządzanie licencją obsługuje Evelode.com. Limit zapytań odnawia się przy odnowieniu licencji lub zmianie planu. Nie odnawia się na początku miesiąca kalendarzowego. Plany roczne obejmują dwanaście miesięcznych limitów połączonych w jedną pulę na cały okres licencji. Historia gromadzi się od momentu uruchomienia zbierania danych. Plan Free nie wiąże się z cykliczną opłatą.
CennikPołącz asystenta AI
Dodaj adres serwera w asystencie, wybierz OAuth i zaloguj się przez Evelode lub wpisz klucz licencyjny na ekranie połączenia. Sekret klienta nie jest wymagany.
https://mcp.uptimescout.com Authorization: Bearer YOUR_EVELODE_LICENSE_KEY
Obsługa odpowiedzi
Przed odczytaniem danych sprawdź kod HTTP: 400 oznacza nieprawidłowe parametry, 401 lub 403 — problem z uwierzytelnieniem lub licencją, 409 — zmianę uprawnień licencyjnych w trakcie żądania, 429 — przekroczenie limitu żądań lub częstotliwości, a 503 — tymczasową niedostępność. Przestrzegaj opóźnień przed ponowieniem żądania i unikaj ponawiania go w krótkich odstępach.
Przykład na podstawie zapisanych obserwacji
{
"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:15.328506Z",
"region": "US",
"service": {
"age_seconds": 13,
"category": "it",
"description": "Platforma do hostowania repozytori\u00f3w Git, wsp\u00f3\u0142pracy nad kodem, obs\u0142ugi zg\u0142osze\u0144 i dostarczania oprogramowania.",
"description_language": "pl",
"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"
}