API-responstijd goed meten: zo doe je dat

Responstijd is een van de belangrijkste eigenschappen van elke API waarop je een integratie bouwt. Als een API traag is, wordt elke workflow die ervan afhankelijk is ook trager, dus precies weten hoe snel hij reageert is geen luxe. Het lastige is dat een enkele meting je zelden de waarheid vertelt.

Waarom een enkele meting niet genoeg is

Latency is nooit een vast getal. Het verschuift met netwerkomstandigheden, serverbelasting, cold starts en rate limiting, waardoor hetzelfde verzoek het ene moment snel en het andere moment traag kan zijn. Voor een betrouwbaar beeld moet je meerdere verzoeken sturen en kijken hoe de resultaten verspreid liggen, niet naar een enkele gelukkige of ongelukkige aanroep.

Kijk naar de verdeling, niet naar het gemiddelde

Een gemiddelde perst alles samen tot een enkel getal en verbergt stilletjes de slechtste gevallen. Lees daarom liever de verdeling: de median (p50) toont de typische ervaring, terwijl p95 de staart blootlegt, wat betekent dat 95% van de verzoeken sneller is dan die waarde. Een groot verschil tussen de median en p95 is een waarschuwing dat sommige verzoeken veel trager zijn dan het gemiddelde doet vermoeden.

• Meet latency over meerdere runs in plaats van te vertrouwen op een enkele aanroep.
• Vergelijk de median (p50) met de p95 om te zien hoe breed de staart is.
• Let op of een cold start het allereerste verzoek omhoog trekt.
• Controleer of rate limits gaan knijpen zodra je meer verzoeken stuurt.

Onze gratis API Speed Test doet precies dit voor je: hij stuurt meerdere verzoeken en rapporteert de min, gemiddelde, median, p95 en max. Hij is gratis en draait volledig via een stateless proxy in je browser, zodat je elk endpoint in seconden kunt meten zonder iets in te richten.