Naar inhoud springen

API-monitoring die het foute antwoord opmerkt.

Uw health-endpoint ziet een kapot inlogproces niet. Uptimia logt in, roept de API aan en controleert de antwoorden — zo krijgt u de mislukte stap, niet een supportticket.

Gratis proefperiode van 30 dagen · tot 50 API-monitoren Geen creditcard AVG-klaar
Snelste interval
60s
Bevestigende locaties
3
Probes
171+
Probe-landen
70+

Het verzoek dat verkeerd terugkwam

Een bestelproces in vijf stappen, volgens schema uitgevoerd. Inloggen, het opzoeken van de bestelling en het totaalbedrag kloppen allemaal — het verzoek daarna niet.

stap 1 Inloggen — token ophalenHet inloggen lukt; de teruggegeven token komt terecht in {{token}} u: ongestoord
stappen 2–3 De API ermee aanroepenGET /orders haalt {{order_id}} op; de bestelling moet het juiste totaalbedrag tonen u: ongestoord
stap 4 Het toevoegen van de bestelnotitie misluktDe assertie benoemt het probleem: de notitie is nooit aangemaakt u: ongestoord
14:32 Elders bevestigd — dan wordt u gewaarschuwdAndere locaties voeren het opnieuw uit en komen tot dezelfde conclusie; de waarschuwing noemt al stap 4 gewaarschuwd: met de oorzaak
stap 4genoemd in de waarschuwing
"Stap 4 is niet door de controle gekomen."14:32
Dat is de hele zoektocht, afgerond voordat u uw laptop opende: de stap, de assertie, en de bevestiging dat het niet aan één probe op een slechte avond lag. De oplossing begint bij het mislukte verzoek — niet bij "de API ligt eruit".
mislukte stap genoemdexacte assertie geciteerdbevestigd vanaf andere locatiesstatus · timing · headers · waarden — per stap
En met alleen een ping? /health antwoordt de hele tijd gewoon prima — een kapotte stap diep in het proces raakt hem nooit. Het eerste signaal is een klant die niet kon afronden, en een zoektocht door logs om te vinden waar het misging. gevonden door een klant

Wat een ping nooit ziet

Een verzoek dat wel slaagt maar de verkeerde gegevens teruggeeft, is nog steeds een mislukking, en een kapotte stap drie verzoeken verderop raakt uw eigen health-endpoint nooit. Richt één monitor op uw eigen API — of op de externe API's waarvan u afhankelijk bent, en weet dat het aan hen ligt, niet aan u.

Statuscodes & headersHet antwoord dat u verwacht, bij elke stap
Waarden in de responsElk veld, stap voor stap gecontroleerd
Fouten halverwege de workflowStap 3 mislukt — een ping ziet dat nooit
Afwijkende responsVerkeerde structuur, ontbrekende velden
15 stappen per keten de hele workflow, echt uitgevoerd
Auth faaltVerlopen tokens, geweigerde logins
TLS- en verbindingsfoutenHandshakes en geweigerde sockets
ResponstijdbudgetElke stap binnen zijn limiet
Waarschuwingen noemen de stap en de assertie die faalde: een mislukt verzoek, een verkeerde waarde in de respons, een ontbrekend veld, een trage stap, een verbindingsfout of een login die niet meer werkt. stap + assertie

Ketens, asserties en timing

De workflow

Schakel tot 15 requests aaneen

Elke stap kan een waarde uit de respons halen — een token, een bestel-ID — in een variabele die latere stappen invoegen als {{name}}. Eén monitor dekt de hele reis van inloggen tot opruimen.

  • 6 HTTP-methoden — GET, POST, PUT, PATCH, DELETE of HEAD, in willekeurige volgorde
  • Extraheer naar variabelen — verderop overal te gebruiken als {{name}}
  • Eigen headers, body en timeout per stap — dupliceer een stap om snel te bouwen
Stuur een echte browser door hetzelfde proces
POST/auth/login1 assertie
GET/orders2 asserties
GET/orders/{{order_id}}3 asserties
POST/orders/{{order_id}}/notes1 assertie
DEL/sessions/{{token}}opruimen
Keten geslaagd1.94 s
Eén monitor doorloopt de hele reis — van inloggen tot opruimen — tot wel elke minuut.
5 stappen7 asserties2 variabelen
Een stap zonder asserties telt nog steeds als geslaagd zodra het verzoek slaagt — voeg controles alleen toe waar ze ertoe doen. elk succes
Asserties

Controleer op status, waarden en timing

Voeg de controles toe die elke stap moet doorstaan: een exacte status, een responstijdbudget, een waarde in de respons-body, een header, of tekst in de respons. Mislukt er één, dan toont de run wat er binnenkwam — en Test uitvoeren raakt de echte endpoint voordat u opslaat.

  • Status en responstijd — de stap mislukt als de code verkeerd is of de respons te traag komt
  • Waarden in de respons — wijs een veld aan en eis dat het aanwezig is, en klopt
  • Respons-headers en body-tekst — eis een headerwaarde, of tekst die aanwezig moet zijn of juist niet mag voorkomen
Let op tekst op een pagina, niet alleen op een status
Test uitvoeren200 · 191 ms
GET /orders/8842 · stap 3 — de live respons, echt opgehaald voordat u opslaat.
{
  "id": 8842,
  "status": "paid",
  "total": 4210
}
status is 200gekregen 200
$.status is gelijk aan "paid"gekregen "paid"
responstijd onder 500 msgekregen 191 ms
Geëxtraheerd {{order_id}} = 8842 voedt de volgende stap — hierboven gemarkeerd in de live respons. = 8842
Timing

DNS, TLS of uw eigen backend

"De API is traag" is nooit het hele verhaal. De tijd van elke stap wordt opgesplitst in vijf fasen — dns, verbinden, tls, wachten, ontvangen — zodat u ziet welke stap vertraagt en of het aan het netwerk ligt of aan uw backend.

  • Timing per stap in vijf fasen — dns, verbinden, tls, wachten, ontvangen
  • Responstijd-per-stap-grafiek — gestapeld, met incidentmarkeringen
  • Traagste stap en traagste runs zichtbaar op de detailpagina van de monitor
Timing per fase voor webpagina's
Stap 4 — traag14:32:16
POST /orders/8842/notes · 1.389 ms totaal, opgesplitst in vijf fasen.
dns18 ms
verbinden31 ms
tls44 ms
wachten1,284 ms
ontvangen12 ms
Netwerk — in orde
dns 18 · connect 31 · tls 44
93 ms
Backend — de vertraging
denktijd voor het eerste byte
1,284 ms
Traagste stap en traagste runs staan op de monitorpagina — een gestapelde grafiek per stap toont wanneer de vertraging begon. traagste
Geheimen

Echte API-sleutels, altijd gemaskeerd

Bewaar wachtwoorden, API-sleutels en tokens als geheime variabelen: alleen-schrijvend, gemaskeerd bij het uitlezen, en weggelakt in getoonde URL's, headers en respons-fragmenten. Niets gevoeligs komt terecht in uw run-historie.

  • Alleen-schrijvende geheime variabelen — gemaskeerd zodra ze worden uitgelezen
  • Overal weggelakt waar ze worden getoond — URL's, headers en body-fragmenten
  • Geëxtraheerde waarden die overeenkomen met een geheim worden ook nooit getoond
Monitoring van pagina's achter een login
API_KEYgeheim
••••••••••••••••alleen-schrijvend
Eén keer opgeslagen, nooit meer getoond — uitlezen geeft value:'' · has_value:true.
Header van stap 1 — wat u instelt
Authorization: Bearer {{API_KEY}}
Run-historie — wat wordt opgeslagen
Authorization: Bearer [redacted]
Ook geëxtraheerde waarden die overeenkomen met een geheim worden nooit getoond — niets gevoeligs komt in de run-historie terecht. gemaskeerd

Schakel de requests één keer aaneen.Laat de mislukte stap benoemen.

Elke stap, elke assertie, elk waarschuwingskanaal — 30 dagen gratis, en niets daarvan is een betaalde add-on.

Start uw gratis proefperiode van 30 dagen
30 dagen gratis geen creditcard altijd opzegbaar

Hoe API-monitoring werkt

Bouw de keten, bewijs hem tegen de live API, en Uptimia voert hem daarna volgens schema uit vanuit ons netwerk — niets te installeren.

Stap 1bouwen

Schakel uw requests aaneen

Voeg elk verzoek op volgorde toe, stel headers en body in, en extraheer de waarden die latere stappen nodig hebben naar variabelen.

Stap 1 · verzoek
POST /auth/login
extraheer $.token → {{token}}
Stap 2 · verzoek
GET /orders
Stap 2bewijzen

Stel asserties in en voer een test uit

Voeg de controles toe die elke stap moet doorstaan, en voer dan Test uitvoeren uit tegen de echte endpoint — volledige resultaten per stap, voordat u opslaat.

Asserties · stap 3
status is 200$.status = "paid"
onder 500 ms
Test uitvoeren · 5/5 stappen geslaagd in 1,9 s
Stap 3elke minuut

Wij voeren het volgens schema uit

Een probe doorloopt de hele keten in één keer, toetst elke assertie en slaat de resultaten per stap op — mislukkingen worden vanaf andere locaties bevestigd voordat er gewaarschuwd wordt.

Run OK — 5/5 stappen
14:31 · 1,8 s · alle asserties geslaagd
op tijd
Run mislukt — stap 4
14:32 · 201 verwacht, 500 gekregen
waarschuwing onderweg

Ook inbegrepen

Slack, PagerDuty, sms en 9 andere

Een API-waarschuwing noemt de mislukte stap en de oorzaak, afgeleverd via dezelfde contacten die elke Uptimia-monitor gebruikt — e-mail, sms, Slack, Teams, Discord, PagerDuty, webhooks en meer.

stap 3 · $.status: "paid" verwacht, "pending" gekregen → Slack · E-mail · PagerDuty

Bevestigd vanaf andere locaties voordat er gewaarschuwd wordt

Een mislukte run wordt eerst opnieuw geprobeerd vanaf andere geschikte locaties.

elders opnieuw uitgevoerd · kwam overeen voordat het incident opende

Dupliceer een stap

Bouw snel een lange keten — kopieer een verzoek en pas het aan.

stap 3 → dupliceren → stap 4

RCA-export voor incidenten

Een gesloten incident bewaart de details per stap — exporteer ze.

RCAPDFHTML

Timeout, headers en body per verzoek

Geef elk verzoek zijn eigen timeout, headers en body.

timeout 10 s · 20 headers · 64 KB body

Elk type monitor in één account

Uw API-monitoren staan naast uptime-, SSL-, heartbeat- en DNS-monitoren — dezelfde contacten, groepen en rollen.

Checkout order flowAPI www.caldmont.comUPTIME db-backup · nightlyHEARTBEAT

Wat is API-monitoring?

API-monitoring is een geautomatiseerde dienst die volgens schema een echte reeks HTTP-verzoeken uitvoert tegen uw REST-API of JSON-endpoint en u waarschuwt zodra een stap de verkeerde status, de verkeerde gegevens teruggeeft of te lang duurt. Het bewaakt de workflow achter een endpoint, niet alleen of de server antwoordde.

Terwijl alles werkt

Hoe werkt API-monitoring?

Uptimia
voert de keten uit
5 stappen · volgens schema
Uw API
elke controle slaagt

Een probe doorloopt elke stap in één keer, evalueert elke assertie en slaat de resultaten per stap op als uw run-historie.

Als een controle mislukt

Eerst bevestigen, dan waarschuwen

Uw API
stap 4 · mislukt
opnieuw uitgevoerd · andere locaties
Uptimia
opent het incident

stap 4 komt niet door de controle → incident opent, waarschuwing noemt de stap

De controles

Wat toetst een API-monitor?

Een stap slaagt standaard bij een succesvolle respons. Voeg asserties toe en de run moet ze bewijzen — een exacte status, een responstijdbudget, een waarde in de respons, een header, of body-tekst.

Gratis tool: status & headers van een endpoint controleren
ControleWat het bewijstVoorbeeld
Statuscodede endpoint antwoordde zoals verwachtis 201 · is één van 200/204 · elke 2xx
Responstijdde stap is snel genoegonder 500 ms
JSON-bodyde respons bevat de juiste gegevens$.status is gelijk aan "paid"
Headerhet juiste content type of de juiste cache-regelContent-Type bevat json
Body-teksteen markering is aanwezig of afwezigbevat "order created"

Veelgestelde vragen over API-monitoring

01Wat is API-monitoring?+
Een geautomatiseerde dienst die volgens schema een echte reeks HTTP-verzoeken uitvoert tegen uw API en de reacties controleert. Eén Uptimia-monitor schakelt tot 15 verzoeken aaneen en waarschuwt u zodra een stap de verkeerde status, de verkeerde gegevens teruggeeft of te lang duurt. U ziet het ook wel synthetische API-monitoring of een geautomatiseerde API-gezondheidscontrole genoemd worden.
02Hoe verschilt dit van een simpele uptime-ping?+
Een ping vertelt u alleen dat de server antwoordde. API-monitoring voert de hele workflow uit en controleert de respons zelf — statuscode, responstijd, headers en de waarden in de JSON. Een 200 die de verkeerde gegevens teruggeeft, wordt hier opgemerkt en blijft voor een gewone ping onzichtbaar.
03Hoe vaak voert Uptimia mijn API-controle uit?+
Standaard elke 5 minuten, en tot wel elke minuut — de planningsronde draait elke minuut, dus één minuut is het minimum. U kunt elke monitor ook langzamer laten draaien voor endpoints met een lagere prioriteit.
04Hoeveel stappen kan één monitor hebben?+
Tot 15 HTTP-verzoeken in één keten, elk met tot 20 headers, 15 asserties en 10 waarde-extracties. De timeout per stap loopt van 1 tot 60 seconden, en de hele keten heeft een run-budget van 90 seconden.
05Voert het JavaScript uit of rendert het de pagina zoals een browser?+
Nee. API-monitoring stuurt gewone HTTP-verzoeken — geen headless browser, geen JavaScript, geen screenshots. Om een echte browser door een gerenderd proces te sturen, gebruikt u de transactiemonitoring van Uptimia; API-monitoring is het lichtere, snellere gereedschap voor de API zelf.
06Kan ik een waarde binnen de JSON-respons controleren?+
Ja. Richt een JSONPath-selector op het veld en eis dat het bestaat, gelijk is aan iets, iets bevat, of onderdeel is van een set. U kunt een waarde ook extraheren naar een variabele en die in latere stappen hergebruiken als {{name}}. De JSONPath-ondersteuning is een gerichte subset voor typische API-respons.
07Ondersteunt u GraphQL of WebSockets?+
GraphQL werkt als een gewone HTTP POST — stuur de query in de body en toets op de JSON die terugkomt — maar er is geen speciale GraphQL-builder. WebSockets worden niet ondersteund; API-monitoring dekt request/response via HTTP (GET, POST, PUT, PATCH, DELETE, HEAD).
08Kan ik een cURL-commando importeren of starten vanuit een sjabloon?+
Niet in deze versie. U bouwt elke stap in de editor — methode, URL, headers, body, asserties, extracties — en kunt een stap dupliceren om snel te werken. cURL-import en een sjabloonbibliotheek horen nog niet bij API-monitoring.
09Hoe voorkomt u vals alarm?+
Een mislukte run wordt vanaf andere locaties opnieuw uitgevoerd voordat er een incident opent — standaard moeten drie locaties het eens zijn (de oorspronkelijke plus twee herhalingen) voordat u gewaarschuwd wordt. Herstel gaat andersom juist snel: één geslaagde run sluit het incident en verstuurt het herstelbericht.
10Zijn mijn API-sleutels veilig binnen een controle?+
Ja. Bewaar inloggegevens als geheime variabelen: alleen-schrijvend, gemaskeerd bij het uitlezen, en weggelakt in getoonde URL's, headers en respons-fragmenten — niets gevoeligs komt in uw run-historie terecht.
11Is API-monitoring een betaalde add-on?+
Nee. Elk pakket bevat API-monitoring naast uptime-, SSL-, transactie-, DNS- en heartbeat-monitoring — nooit als betaalde add-on. Zelfs het gratis pakket komt met één API-monitor; pakketten verschillen alleen in hoeveel er inbegrepen zijn, en de gratis proefperiode van 30 dagen bevat er tot 50, zonder creditcard.

Begin vandaag nog met het monitoren van uw API.

Bouw de keten, bewijs hem tegen de live endpoint — en de volgende keer dat een stap breekt, vertelt de waarschuwing u al welke.

30 dagen gratis proefperiode Tot 50 API-monitoren Geen creditcard AVG-klaar
API-monitoring sluit aan bij uptime-, SSL-, snelheids-, transactie-, DNS- en heartbeat-monitoring onder één Uptimia-login.