uptimescout
Uzyskaj klucz API

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ługi

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

Cennik

Połą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.

Połącz UptimeScout

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"
}

Szybki podgląd

Wczytywanie zapisanych obserwacji

Sygnały w czasie

Każdy przedział pokazuje najczęściej obserwowany sygnał. W przypadku remisu decyduje najpóźniejsza obserwacja spośród stanów z remisu. Wybierz kolumnę, aby zobaczyć pełne zestawienie.