Αναφορά API
Χτίστε πάνω από το BeeCastly με το πλήρες API REST μας. Διαχειριστείτε τις επαφές, στείλτε μηνύματα, δημιουργήστε καμπάνιες και διαμορφώστε τα webhook μέσω προγραμματισμού.
Βασική διεύθυνση URL
https://beecastly.com/apiΌλα τα τελικά σημεία API είναι σχετικά με αυτό το βασικό URL. Τα αιτήματα πρέπει να περιλαμβάνουν έγκυρο κλειδί API ή διακριτικό JWT.
Γρήγορη εκκίνηση
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"
Πιστοποίηση
Όλα τα αιτήματα απαιτούν έλεγχο ταυτότητας μέσω ενός από:
- Κλειδί API — Περάστε στην κεφαλίδα Εξουσιοδότηση: Φορέας YOUR_API_KEY
- JWT Token — Λήφθηκε από το POST /auth/login
Επιπλέον, συμπεριλάβετε το αναγνωριστικό μισθωτή σας: x-tenant-id: YOUR_TENANT_ID
Τελικά σημεία API
Πιστοποίηση
Είσοδος, εγγραφή, κλειδιά API, διακριτικά JWT
Επαφές
Λειτουργίες CRUD, ετικέτες, τμήματα, προσαρμοσμένα πεδία
Μηνύματα
Στείλτε WhatsApp, Email, SMS. Λήψη συνομιλιών
καμπάνιες
Δημιουργήστε, προγραμματίστε και παρακολουθήστε καμπάνιες
Webhooks
Συνδρομές εκδηλώσεων, ωφέλιμα φορτία, επαλήθευση
Bots
Συνεδρίες bot AI, μηνύματα και δεδομένα εκπαίδευσης
Μορφή απόκρισης
Όλες οι απαντήσεις ακολουθούν μια συνεπή μορφή JSON:
// Success
{
"success": true,
"data": { ... }
}
// Error
{
"success": false,
"error": "Error message description"
}Όρια ποσοστού
Δωρεάν βαθμίδα: 100 αιτήματα/λεπτό
Επαγγελματικό επίπεδο: 1.000 αιτήματα/λεπτό
Επιχείρηση: Προσαρμοσμένα όρια
Οι κεφαλίδες ορίου ρυθμού περιλαμβάνονται σε κάθε απάντηση: X-RateLimit-Remaining