API-referentie
Bouw bovenop BeeCastly met onze volledig uitgeruste REST API. Beheer contacten, verzend berichten, maak campagnes en configureer webhooks programmatisch.
Basis-URL
https://beecastly.com/apiAlle API-eindpunten zijn relatief ten opzichte van deze basis-URL. Aanvragen moeten een geldige API-sleutel of JWT-token bevatten.
Snel beginnen
curl -X GET https://beecastly.com/api/contacts \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "x-tenant-id: YOUR_TENANT_ID" \ -H "Content-Type: application/json"
Authenticatie
Voor alle verzoeken is authenticatie vereist via een van:
- API-sleutel — Geef de header Authorization: Bearer YOUR_API_KEY door
- JWT-token — Verkregen via POST /auth/login
Voeg bovendien uw tenant-ID toe: x-tenant-id: YOUR_TENANT_ID
API-eindpunten
Authenticatie
Inloggen, registreren, API-sleutels, JWT-tokens
Contacten
CRUD-bewerkingen, tags, segmenten, aangepaste velden
Berichten
Stuur WhatsApp, e-mail, sms. Gesprekken ophalen
Campagnes
Campagnes maken, plannen en volgen
Webhaken
Evenementabonnementen, payloads, verificatie
Botten
AI-botsessies, berichten en trainingsgegevens
Antwoordformaat
Alle antwoorden volgen een consistent JSON-formaat:
// Success
{
"success": true,
"data": { ... }
}
// Error
{
"success": false,
"error": "Error message description"
}Tarieflimieten
Gratis niveau: 100 verzoeken/minuut
Pro-niveau: 1.000 verzoeken/minuut
Enterprise: aangepaste limieten
In elk antwoord zijn headers met tarieflimieten opgenomen: X-RateLimit-Remaining