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- Succesvol400- Onjuiste request401- Niet geauthenticeerd403- Geen toegang404- Niet gevonden429- Te veel requests500- 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.