# Monitoring API

Source: https://instatus.com/help/pl/monitoring/api

Monitory API wysyłają konfigurowalne żądanie HTTP do endpointu co 30 sekund i alarmują Cię, gdy jest on nieosiągalny, odpowiada wolno lub zwraca błędne dane. Kontrolujesz metodę, nagłówki, treść i uwierzytelnianie, a asercje możesz nakładać na kod statusu, treść JSON, nagłówki i czas odpowiedzi.

Podobnie jak w przypadku [innych monitorów](https://instatus.com/help/pl/monitoring), gdy monitor API wykryje problem, możesz wspólnie z zespołem [rozwiązać incydent](https://instatus.com/help/pl/incident-response) i opcjonalnie zaktualizować swoją [stronę statusu](https://instatus.com/help/pl/status-page).

| At a glance | Details |
| :-- | :-- |
| [Częstotliwość](https://instatus.com/help/pl/monitoring/api#ustawienia-zaawansowane) | Co 30 sekund |
| [Metody HTTP](https://instatus.com/help/pl/monitoring/api#konfiguracja-żądania) | GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD |
| [Treść żądania](https://instatus.com/help/pl/monitoring/api#konfiguracja-żądania) | JSON, dane formularza, GraphQL, zwykły tekst |
| [Uwierzytelnianie](https://instatus.com/help/pl/monitoring/api#konfiguracja-żądania) | Basic auth, klucz API, token Bearer |
| [Asercje](https://instatus.com/help/pl/monitoring/api#monitor-jest-udany-jeśli) | Kod statusu, czas odpowiedzi, treść, JSON, nagłówki |
| [Lokalizacje sprawdzeń](https://instatus.com/help/pl/monitoring/api#ustawienia-zaawansowane) | Stany Zjednoczone, Kanada, Europa, Azja |

![Monitor](https://instatus.com/help/monitors/item.png)

## Co sprawdza monitor API?

- Testowanie endpointów API z różnych lokalizacji na świecie co 30 sekund.
- Weryfikacja kodów statusu HTTP, treści JSON, nagłówków i czasów odpowiedzi.
- Możliwość dodania własnych nagłówków, parametrów zapytania lub ładunków JSON.
- Natychmiastowe powiadomienia, gdy endpoint nie działa, działa wolno lub zwraca nieoczekiwane wyniki.
- Integracja ze Slackiem, e-mailem, SMS-ami, połączeniami telefonicznymi, webhookami i nie tylko.

## Jak dodać monitor API?

Przejdź do swojego projektu → Monitory → Dodaj monitor, wybierz **API**, wpisz adres URL endpointu, skonfiguruj żądanie i ustaw asercje oznaczające, że endpoint działa poprawnie.

![Dodaj monitor API](https://instatus.com/help/monitors/API.png)

### Typ monitora

Wybierz **API** jako typ monitora.

![Typ monitora: API](https://instatus.com/help/monitors/type-api.png)

Wpisz adres URL endpointu, który chcesz monitorować — na przykład  
`https://api.yourservice.com/v1/users`.

### Konfiguracja żądania

Żądanie API możesz dostosować w pełni:

- **Metoda HTTP:** `GET`, `POST`, `PUT`, `PATCH`, `DELETE`, `OPTIONS` lub `HEAD`
- **Treść:** Wyślij wraz z żądaniem dane JSON, dane formularza, GraphQL lub zwykły tekst
- **Uwierzytelnianie:** Dodaj uwierzytelnianie basic, klucz API lub token Bearer
- **Parametry zapytania:** Dołącz pary klucz/wartość do adresu URL żądania
- **Nagłówki:** Dodaj własne nagłówki wymagane przez Twoje API

### Monitor jest udany, jeśli

Monitor API kończy się powodzeniem, gdy spełnione są wszystkie wskazane asercje.  
Możesz ustawić jedną lub więcej z poniższych asercji:

- **Kod statusu:** np. odpowiedź to `200 OK`
- **Czas odpowiedzi:** np. poniżej `1 sekundy`
- **Treść zawiera:** np. `"success": true`
- **Ścieżka JSON:** np. `data.status` równe `"active"`
- **Nagłówek zawiera:** np. `Content-Type: application/json`

Jeśli którykolwiek z tych warunków nie zostanie spełniony, monitor zostanie oznaczony jako **niedziałający**, a alerty zostaną wysłane zgodnie z Twoimi [ustawieniami alertów](https://instatus.com/help/pl/monitoring/alerts).

### Ustawienia zaawansowane

![Zaawansowane ustawienia monitora](https://instatus.com/help/monitors/advanced-settings.png)

- **Nazwa własna:** Nadaj monitorowi opisową nazwę, aby łatwiej go rozpoznać.
- **Uruchamiaj sprawdzenia co:** Zdecyduj, jak często testować endpoint.
- **Uruchamiaj z:** Wybierz lokalizacje testowe (Stany Zjednoczone, Kanada, Europa, Azja).
- **Dodaj do strony statusu:** Publicznie prezentuj dostępność API i statystyki odpowiedzi.
- **Gdy monitor wykryje awarię:** Utwórz incydent, powiadom subskrybentów lub opublikuj informację na stronie statusu.
- **Gdy monitor wykryje powrót do działania:** Rozwiąż incydenty i automatycznie zaktualizuj stronę statusu.

Gratulacje, pierwszy monitor API dodany!

- [Monitoring cron](https://instatus.com/help/pl/monitoring/cron): Dowiedz się, jak monitorować zaplanowane zadania i procesy w tle