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

URL: https://uptimescout.com/pl/docs/

## REST

```sh
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/services`: Wyszukuj usługi w katalogu i przeglądaj go strona po stronie.

- `GET /v1/status`: Odczytuj aktualny zapisany status jednej usługi.

- `GET /v1/statuses`: Odczytuj statusy wielu usług w jednym żądaniu.

- `GET /v1/summary`: Podsumowuj zaobserwowane sygnały dla regionu lub wybranych usług.

- `GET /v1/history`: Odczytuj zapisane obserwacje z różnych okresów i przeglądaj je strona po stronie.

- `GET /v1/stats`: Obliczaj proporcje zapisanych próbek sygnałów, a nie zmierzoną dostępność.

- `GET /v1/incidents`: Wyś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.

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

## Połącz asystenta AI

Połącz klienta MCP obsługującego Streamable HTTP z poniższym punktem końcowym i podaj klucz licencyjny w nagłówku Authorization. Siedem narzędzi tylko do odczytu udostępnia statusy usług, sygnały regionalne i historię. Obowiązują te same limity licencji.

https://mcp.uptimescout.com

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

OpenAPI: https://uptimescout.com/openapi.json
