API-overzicht
Overzicht
De Klantel API bestaat uit twee categorieën:
- Server Actions — Next.js server-side functies die de web-applicatie aandrijven (niet publiek bedoeld)
- API Routes — publieke HTTP-eindpunten voor integraties en geautomatiseerde taken
notitie
Klantel heeft momenteel geen volledig publieke REST API voor externe integraties. De beschikbare API-eindpunten zijn bedoeld voor systeem-interne doeleinden (cron, webhooks).
Basis-URL
https://app.klantel.be
Of je eigen domein bij self-hosting.
Authenticatie
Alle web-eindpunten vereisen een sessie-cookie. Zie Authenticatie.
Speciale eindpunten (cron) gebruiken een Bearer-token. Zie Cron-eindpunten.
Rate limiting
Klantel past rate limiting toe op kritieke eindpunten:
| Eindpunt | Limiet | Blokkeerperiode |
|---|---|---|
POST /login | 5 pogingen / 15 min | 15 min |
POST /registreer | 3 pogingen / uur | 1 uur |
| VIES-lookup | 5 opzoekingen / uur | 1 uur |
Bij overschrijding geeft de API een 429 Too Many Requests terug.
Foutformaat
Alle API-fouten volgen dit formaat:
{
"errors": {
"veld": ["Foutmelding"],
"_form": ["Algemene fout"]
}
}