Referință API
Construiți-vă pe BeeCastly cu API-ul nostru REST cu funcții complete. Gestionați contacte, trimiteți mesaje, creați campanii și configurați webhook-uri în mod programatic.
Adresa URL de bază
https://beecastly.com/apiToate punctele finale API sunt relativ la această adresă URL de bază. Solicitările trebuie să includă o cheie API sau un token JWT valid.
Pornire rapidă
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"
Autentificare
Toate cererile necesită autentificare prin una dintre:
- Cheie API — Transmiteți antetul Autorizare: Purtător YOUR_API_KEY
- Token JWT — Obținut de la POST /auth/login
În plus, includeți ID-ul de chiriaș: x-tenant-id: YOUR_TENANT_ID
Puncte finale API
Autentificare
Autentificare, înregistrare, chei API, jetoane JWT
Contacte
Operațiuni CRUD, etichete, segmente, câmpuri personalizate
Mesaje
Trimite WhatsApp, e-mail, SMS. Preluați conversații
Campanii
Creați, programați și urmăriți campanii
Webhook-uri
Abonamente la evenimente, încărcături utile, verificare
roboții
Sesiuni bot AI, mesaje și date de antrenament
Format de răspuns
Toate răspunsurile urmează un format JSON consecvent:
// Success
{
"success": true,
"data": { ... }
}
// Error
{
"success": false,
"error": "Error message description"
}Limite de rate
Nivel gratuit: 100 cereri/minut
Nivelul profesional: 1.000 de solicitări/minut
Întreprindere: limite personalizate
Anteturile pentru limita de rată sunt incluse în fiecare răspuns: X-RateLimit-Remaining