API Overzicht

n8n community node beschikbaarVoor low-code integraties kun je gebruik maken van onze n8n community node. Dit maakt het eenvoudig om Sleak te integreren in je automatiseringsworkflows.

Authenticatie

De Sleak API gebruikt Bearer token authenticatie. Voeg je API key toe aan de Authorization header:

Authorization: Bearer YOUR_API_KEY

Je kunt je API key vinden in het dashboard onder Instellingen > API.

Base URL

https://api.v1.sleak.chat

Endpoints

De API biedt de volgende endpoints:

POST /api/conversation

Start een nieuwe conversatie met een chatbot

POST /api/message

Verstuur een bericht binnen een bestaande conversatie

Rate Limiting

De API hanteert rate limiting om overbelasting te voorkomen. Rate limit informatie wordt teruggegeven in de response headers:

X-RateLimit-Limit: Maximaal aantal requests per minuut
X-RateLimit-Remaining: Aantal resterende requests
X-RateLimit-Reset: Unix timestamp wanneer de rate limit reset

Bij het overschrijden van de rate limit ontvang je een 429 Too Many Requests response.

Error Handling

Alle errors worden geretourneerd in het volgende format:

{
  "error": {
    "code": "error_code",
    "message": "Foutbeschrijving",
    "details": {}
  }
}

HTTP Status Codes:

200: Succesvol verwerkt
400: Ongeldige aanvraag
401: Niet geautoriseerd
403: Geen toegang tot deze resource
404: Resource niet gevonden
429: Rate limit overschreden
500: Interne server fout

Code Voorbeelden

cURL

# Start een conversatie
curl -X POST https://api.v1.sleak.chat/api/conversation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chatbot_id": "chatbot_123", "visitor_id": "visitor_456"}'

# Verstuur een bericht
curl -X POST https://api.v1.sleak.chat/api/message \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id": "conv_789", "message": "Hallo!"}'

Python

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.v1.sleak.chat"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Start conversatie
response = requests.post(
    f"{BASE_URL}/api/conversation",
    headers=headers,
    json={"chatbot_id": "chatbot_123", "visitor_id": "visitor_456"}
)
conversation_id = response.json()["conversation_id"]

# Verstuur bericht
response = requests.post(
    f"{BASE_URL}/api/message",
    headers=headers,
    json={"conversation_id": conversation_id, "message": "Hallo!"}
)
messages = response.json()

JavaScript (Node.js)

const axios = require('axios');

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://api.v1.sleak.chat';

const headers = {
  'Authorization': `Bearer ${API_KEY}`,
  'Content-Type': 'application/json'
};

// Start conversatie
const conversation = await axios.post(
  `${BASE_URL}/api/conversation`,
  { chatbot_id: 'chatbot_123', visitor_id: 'visitor_456' },
  { headers }
);

const conversationId = conversation.data.conversation_id;

// Verstuur bericht
const response = await axios.post(
  `${BASE_URL}/api/message`,
  { conversation_id: conversationId, message: 'Hallo!' },
  { headers }
);

Email Support

[email protected]

Bel ons

+31 85 060 8199

​Authenticatie

​Base URL

​Endpoints

POST /api/conversation

POST /api/message

​Rate Limiting

​Error Handling

​Code Voorbeelden

​cURL

​Python

​JavaScript (Node.js)

Email Support

Bel ons

Authenticatie

Base URL

Endpoints

Rate Limiting

Error Handling

Code Voorbeelden

cURL

Python

JavaScript (Node.js)