> ## Documentation Index
> Fetch the complete documentation index at: https://docs.klantel.be/llms.txt
> Use this file to discover all available pages before exploring further.

# API-overzicht

> Klantel REST API — basis-URL, authenticatie en limieten

## Overzicht

De Klantel API bestaat uit twee categorieën:

1. **Server Actions** — Next.js server-side functies die de web-applicatie aandrijven (niet publiek bedoeld)
2. **API Routes** — publieke HTTP-eindpunten voor integraties en geautomatiseerde taken

<Note>
  Klantel heeft momenteel geen volledig publieke REST API voor externe integraties.
  De beschikbare API-eindpunten zijn bedoeld voor systeem-interne doeleinden (cron, webhooks).
</Note>

## Basis-URL

```
https://app.klantel.be
```

Of je eigen domein bij self-hosting.

## Authenticatie

Alle web-eindpunten vereisen een sessie-cookie. Zie [Authenticatie](/api/authenticatie).

Speciale eindpunten (cron) gebruiken een `Bearer`-token. Zie [Cron-eindpunten](/api/cron-endpoints).

## 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:

```json theme={null}
{
  "errors": {
    "veld": ["Foutmelding"],
    "_form": ["Algemene fout"]
  }
}
```

## Verwante pagina's

<CardGroup cols={2}>
  <Card title="Authenticatie" icon="key" href="/api/authenticatie">
    Sessie-gebaseerde authenticatie
  </Card>

  <Card title="Cron-eindpunten" icon="clock" href="/api/cron-endpoints">
    Geautomatiseerde taken
  </Card>
</CardGroup>