API Documentatie

Authenticatie

Alle API requests vereisen authenticatie via een API key. Je kunt je API key genereren in het dashboard onder Instellingen > API Toegang.

Authorization: Bearer YOUR_API_KEY

Endpoints

Gesprekken

POST /api/v1/conversations

Start een nieuw gesprek

{
  "user_id": "string",
  "initial_message": "string",
  "language": "nl",
  "channel": "web|whatsapp|messenger"
}

GET /api/v1/conversations/{id}

Haal gespreksdetails op

Berichten

POST /api/v1/messages

Verstuur een bericht in een gesprek

{
  "conversation_id": "string",
  "content": "string",
  "type": "text|image|file"
}

Rate Limiting

API requests zijn gelimiteerd tot 100 requests per minuut per API key. Bij overschrijding ontvang je een 429 Too Many Requests response.

Webhooks

Je kunt webhooks configureren om real-time updates te ontvangen over gesprekken en berichten. Zie de Webhooks documentatie voor meer details.

Foutafhandeling

HTTP Status Codes

  • 200 - Succesvol
  • 400 - Onjuiste request
  • 401 - Niet geauthenticeerd
  • 403 - Geen toegang
  • 404 - Niet gevonden
  • 429 - Te veel requests
  • 500 - Server error

SDK's & Libraries

  • Node.js SDK
  • Python SDK
  • PHP SDK
  • Java SDK

Tip

Gebruik onze officiële SDK's voor de beste ontwikkelervaring en automatische error handling.