# API-monitoring

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

API-monitors sturen elke 30 seconden een configureerbaar HTTP-verzoek naar een endpoint en waarschuwen je wanneer het onbereikbaar of traag is of de verkeerde data teruggeeft. Je bepaalt de methode, headers, body en authenticatie en stelt voorwaarden aan de statuscode, JSON-body, headers en responstijd.

Net als bij [andere monitors](https://instatus.com/help/nl/monitoring) kun je, wanneer een API-monitor een probleem vindt, samen met je team [het incident oplossen](https://instatus.com/help/nl/incident-response) en eventueel je [statuspagina](https://instatus.com/help/nl/status-page) bijwerken.

| At a glance | Details |
| :-- | :-- |
| [Checkfrequentie](https://instatus.com/help/nl/monitoring/api#geavanceerde-instellingen) | Elke 30 seconden |
| [HTTP-methoden](https://instatus.com/help/nl/monitoring/api#configuratie-van-het-verzoek) | GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD |
| [Verzoekbody](https://instatus.com/help/nl/monitoring/api#configuratie-van-het-verzoek) | JSON, formulierdata, GraphQL, platte tekst |
| [Authenticatie](https://instatus.com/help/nl/monitoring/api#configuratie-van-het-verzoek) | Basic auth, API-sleutel, Bearer-token |
| [Voorwaarden](https://instatus.com/help/nl/monitoring/api#de-monitor-slaagt-als) | Statuscode, responstijd, body, JSON-pad, headers |
| [Checklocaties](https://instatus.com/help/nl/monitoring/api#geavanceerde-instellingen) | Verenigde Staten, Canada, Europa, Azië |

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

## Wat controleert een API-monitor?

- Test je API-endpoints elke 30 seconden vanaf verschillende locaties wereldwijd.
- Valideer HTTP-statuscodes, de JSON-body, headers en responstijden.
- Voeg eigen headers, query-parameters of JSON-payloads toe.
- Krijg meteen bericht als een endpoint down is, traag is of onverwachte resultaten teruggeeft.
- Koppel met Slack, e-mail, sms, telefoontjes, webhooks en meer.

## Hoe voeg ik een API-monitor toe?

Ga naar je project → Monitors → Monitor toevoegen, kies **API**, vul de URL van het endpoint in, configureer het verzoek en stel de voorwaarden in waaraan een gezond endpoint voldoet.

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

### Type monitor

Kies **API** als type monitor.

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

Vul de URL van het endpoint in dat je wilt monitoren — bijvoorbeeld  
`https://api.yourservice.com/v1/users`.

### Configuratie van het verzoek

Je kunt je API-verzoek volledig naar wens instellen:

- **HTTP-methode:** `GET`, `POST`, `PUT`, `PATCH`, `DELETE`, `OPTIONS` of `HEAD`
- **Body:** stuur JSON, formuliergegevens, GraphQL of platte tekst mee met je verzoek
- **Auth:** voeg basic authentication, een API-sleutel of Bearer-tokenautorisatie toe
- **Query-parameters:** hang sleutel/waarde-paren aan je verzoek-URL
- **Headers:** voeg de eigen headers toe die je API-verzoek nodig heeft

### De monitor slaagt als

Een API-monitor slaagt wanneer aan alle opgegeven controles is voldaan.  
Je kunt een of meer van de volgende controles instellen:

- **Statuscode:** bijvoorbeeld respons is `200 OK`
- **Responstijd:** bijvoorbeeld onder `1 second`
- **Body bevat:** bijvoorbeeld `"success": true`
- **JSON-pad:** bijvoorbeeld `data.status` is gelijk aan `"active"`
- **Header bevat:** bijvoorbeeld `Content-Type: application/json`

Als aan een van deze voorwaarden niet wordt voldaan, wordt de monitor als **down** gemarkeerd en gaan er meldingen uit volgens je [meldingsinstellingen](https://instatus.com/help/nl/monitoring/alerts).

### Geavanceerde instellingen

![Geavanceerde monitorinstellingen](https://instatus.com/help/monitors/advanced-settings.png)

- **Herkenbare naam:** Geef je monitor een beschrijvende naam zodat je hem makkelijk herkent.
- **Checks uitvoeren elke:** Bepaal hoe vaak het endpoint getest wordt.
- **Uitvoeren vanaf:** Kies de testlocaties (Verenigde Staten, Canada, Europa, Azië).
- **Toevoegen aan statuspagina:** Toon de uptime en responscijfers van je API publiekelijk.
- **Wanneer een monitor faalt:** Start een incident, waarschuw abonnees of publiceer op je statuspagina.
- **Wanneer een monitor herstelt:** Los incidenten op en werk je statuspagina automatisch bij.

Gefeliciteerd, je hebt je eerste API-monitor toegevoegd!

- [Cron-monitoring](https://instatus.com/help/nl/monitoring/cron): Leer hoe je geplande taken en achtergrondprocessen monitort