# Monitoring API

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

API monitory každých 30 sekund posílají na endpoint konfigurovatelný HTTP požadavek a upozorní vás, když je nedostupný, pomalý nebo vrací špatná data. Určujete metodu, hlavičky, tělo i autentizaci a ověřujete stavový kód, tělo JSON, hlavičky a dobu odezvy.

Podobně jako u [ostatních monitorů](https://instatus.com/help/cs/monitoring) platí, že když monitor API odhalí problém, můžete [incident vyřešit](https://instatus.com/help/cs/incident-response) společně s týmem a volitelně aktualizovat svou [stavovou stránku](https://instatus.com/help/cs/status-page).

| At a glance | Details |
| :-- | :-- |
| [Frekvence kontrol](https://instatus.com/help/cs/monitoring/api#pokročilá-nastavení) | Každých 30 sekund |
| [HTTP metody](https://instatus.com/help/cs/monitoring/api#konfigurace-požadavku) | GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD |
| [Tělo požadavku](https://instatus.com/help/cs/monitoring/api#konfigurace-požadavku) | JSON, formulářová data, GraphQL, prostý text |
| [Autentizace](https://instatus.com/help/cs/monitoring/api#konfigurace-požadavku) | Basic auth, API klíč, Bearer token |
| [Podmínky](https://instatus.com/help/cs/monitoring/api#monitor-je-úspěšný-když) | Stavový kód, doba odezvy, tělo, JSON path, hlavičky |
| [Lokality kontrol](https://instatus.com/help/cs/monitoring/api#pokročilá-nastavení) | Spojené státy, Kanada, Evropa, Asie |

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

## Co kontroluje API monitor?

- Testování API endpointů z různých lokalit po celém světě každých 30 sekund.
- Ověřování HTTP stavových kódů, těla JSON, hlaviček a dob odezvy.
- Vlastní hlavičky, parametry dotazu nebo JSON payloady.
- Okamžité upozornění, když je endpoint nedostupný, pomalý nebo vrací neočekávané výsledky.
- Napojení na Slack, e-mail, SMS, telefonáty, webhooky a další.

## Jak přidám API monitor?

Přejděte do svého projektu → Monitory → Přidat monitor, zvolte **API**, zadejte URL endpointu, nakonfigurujte požadavek a nastavte podmínky, za kterých je endpoint v pořádku.

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

### Typ monitoru

Jako typ monitoru zvolte **API**.

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

Zadejte URL endpointu, který chcete monitorovat — například  
`https://api.yourservice.com/v1/users`.

### Konfigurace požadavku

Požadavek na API si můžete plně přizpůsobit:

- **HTTP metoda:** `GET`, `POST`, `PUT`, `PATCH`, `DELETE`, `OPTIONS` nebo `HEAD`
- **Tělo:** Pošlete s požadavkem JSON, form data, GraphQL nebo prostý text
- **Ověření:** Přidejte basic authentication, API klíč nebo autorizaci přes Bearer token
- **Parametry dotazu:** Připojte k URL požadavku dvojice klíč/hodnota
- **Hlavičky:** Přidejte vlastní hlavičky, které váš požadavek potřebuje

### Monitor je úspěšný, když

Monitor API je úspěšný, když jsou splněné všechny zadané podmínky.  
Nastavit můžete jednu nebo víc z těchto kontrol:

- **Stavový kód:** např. odpověď je `200 OK`
- **Doba odezvy:** např. pod `1 sekundu`
- **Tělo obsahuje:** např. `"success": true`
- **Cesta v JSON:** např. `data.status` se rovná `"active"`
- **Hlavička obsahuje:** např. `Content-Type: application/json`

Pokud některá z podmínek splněná není, monitor se označí jako **nedostupný** a rozešlou se upozornění podle vašeho [nastavení upozornění](https://instatus.com/help/cs/monitoring/alerts).

### Pokročilá nastavení

![Pokročilá nastavení monitoru](https://instatus.com/help/monitors/advanced-settings.png)

- **Popisný název:** Pojmenujte monitor výstižně, ať ho snadno poznáte.
- **Spouštět kontroly každých:** Rozhodněte, jak často se má endpoint testovat.
- **Spouštět z:** Vyberte testovací lokality (Spojené státy, Kanada, Evropa, Asie).
- **Přidat na stavovou stránku:** Zveřejněte dostupnost API a statistiky odezvy.
- **Když monitor selže:** Založte incident, upozorněte odběratele nebo publikujte na stavovou stránku.
- **Když se monitor obnoví:** Vyřešte incidenty a automaticky aktualizujte stavovou stránku.

Gratulujeme, přidali jste svůj první monitor API!

- [Cron monitoring](https://instatus.com/help/cs/monitoring/cron): Naučte se sledovat naplánované úlohy a procesy na pozadí