Riferimento API
Costruisci su BeeCastly con la nostra API REST completa. Gestisci i contatti, invia messaggi, crea campagne e configura i webhook in modo programmatico.
URL di base
https://beecastly.com/apiTutti gli endpoint API sono relativi a questo URL di base. Le richieste devono includere una chiave API o un token JWT valido.
Avvio rapido
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"
Autenticazione
Tutte le richieste richiedono l'autenticazione tramite uno dei seguenti:
- Chiave API: passa l'autorizzazione: Bearer YOUR_API_KEY intestazione
- Token JWT: ottenuto da POST /auth/login
Inoltre, includi il tuo ID tenant: x-tenant-id: YOUR_TENANT_ID
Endpoint API
Autenticazione
Accedi, registrati, chiavi API, token JWT
Contatti
Operazioni CRUD, tag, segmenti, campi personalizzati
Messaggi
Invia WhatsApp, e-mail, SMS. Recupera conversazioni
Campagne
Crea, pianifica e monitora le campagne
Webhook
Iscrizioni a eventi, payload, verifica
Bot
Sessioni, messaggi e dati di addestramento del bot AI
Formato della risposta
Tutte le risposte seguono un formato JSON coerente:
// Success
{
"success": true,
"data": { ... }
}
// Error
{
"success": false,
"error": "Error message description"
}Limiti di velocità
Livello gratuito: 100 richieste/minuto
Livello Pro: 1.000 richieste/minuto
Azienda: limiti personalizzati
Le intestazioni del limite di velocità sono incluse in ogni risposta: X-RateLimit-Remaining