BESS AI API
BESS AI REST API'si; ajanlar oluşturmanızı, telefon araması yapıp bunları analiz etmenizi, sohbet oturumları çalıştırmanızı, telefon numaralarını ve widget'ları yönetmenizi, toplu (batch) kampanyalar başlatmanızı ve konuşma sonrası iş akışlarını otomatikleştirmenizi sağlar — console'un yaptığı her şeyi programatik olarak.
Base URL: https://api.bess-ai.com
Kimlik doğrulama
console üzerinde Settings → API Keys altından bir API key oluşturun ve her istekte bearer token olarak gönderin:
curl https://api.bess-ai.com/v1/calls \
-H "Authorization: Bearer bess_sk_live_..."
Key, oluşturulduğunda yalnızca bir kez gösterilir — güvenli bir şekilde saklayın, asla
client-side kodda tutmayın. Key'ler kapsamlıdır (scoped) (örneğin calls:read, calls:write,
chat:write, agents:read): key'in kapsamının dışına çıkan bir istek 403 döner.
Tipli bir istemci mi tercih ediyorsunuz? pip install bessai / npm install bessai — bkz. SDKs.
Bu referanstaki her endpoint sayfasında, SDK'nın kapsadığı yerlerde curl ve ham HTTP örneklerinin
yanında bir Python (bessai) sekmesi bulunur.
Hatalar
Hatalar, sorunu açıklayan JSON gövdeli standart HTTP durum kodlarıdır:
| Status | Anlamı |
|---|---|
401 | API key eksik, geçersiz veya süresi dolmuş. |
403 | Key'in kapsamı bu işleme izin vermiyor. |
404 | Kaynak mevcut değil (veya başka bir organizasyona ait). |
409 | Kaynağın mevcut durumuyla çakışma. |
422 | Doğrulama hatası — gövde, sorunlu alanları listeler. |
429 | Hız sınırına ulaşıldı — Retry-After başlığından sonra yeniden deneyin. |
5xx | Sunucu tarafı hata — backoff ile yeniden denemek güvenlidir. |
Hız sınırları
Limitler plan katmanına göre API key başına, dakikalık ve günlük olarak uygulanır. Başarılı
yanıtlar X-RateLimit-* başlıklarını içerir; 429 yanıtları Retry-After içerir.
Resmi SDK'lar 429 ve geçici 5xx hatalarını üstel backoff ile otomatik olarak yeniden dener.
Webhook'lar
Console üzerinden konuşma yaşam döngüsü olaylarına (call started/ended, analysis ready) abone olun. Webhook payload'ları HMAC ile imzalanır — gövdeye güvenmeden önce imza başlığını doğrulayın.