API-overzicht - Klantel

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

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"]
  }
}

Verwante pagina’s

Authenticatie

Sessie-gebaseerde authenticatie

Cron-eindpunten

Geautomatiseerde taken

Authenticatie

​Overzicht

​Basis-URL

​Authenticatie

​Rate limiting

​Foutformaat

​Verwante pagina’s

Authenticatie

Cron-eindpunten

Overzicht

Basis-URL

Authenticatie

Rate limiting

Foutformaat

Verwante pagina’s