Rate Limiting (İstek Limitleri)

Bulut Santralim API'sindeki tüm endpoint'ler, aynı domain/IP üzerinden gelen istekler için istek limitlerine (rate limiting) tabidir. Sınır aşıldığında API 429 (Too Many Requests) HTTP durum kodu döner.

Varsayılan Limit

Aşağıdaki tabloda özel bir limiti belirtilmeyen tüm diğer endpoint'ler (mute, transfer, hangup, answer, dnd, report_event, announcements, caller_ids, update_outbound_caller_id, voicemail_*, phonebook, blocked_numbers, advisory_webhook, fax_*/fdrs, webphone_iframe, crm_integrations, queues, queue/manage_users, queue/user_list vb.) genel varsayılan limite tabidir: saniyede 2 istek (yaklaşık dakikada 120), burst 10.

Endpoint Bazlı Özel Limitler

Endpoint	Limit	Burst	Not
/originate (çağrı başlatma)	saniyede 3 istek (yaklaşık dakikada 180)	100	Bkz. Çağrı Yönetimi
/agent_statuses ve /user_statuses	dakikada toplam 2 istek	–	İki endpoint aynı limit havuzunu paylaşır — biri isteği tüketirse diğeri de o dakika için sınıra takılır. Bkz. Çağrı Yönetimi, Kuyruklar
/recording_url	dakikada 5 istek	–	Bkz. Ses Kayıtları
/queues/pending	dakikada 10 istek	–	Kuyruk listesi (/queues) ve dahili yönetimi endpoint'leri (queue/manage_users, queue/user_list) bu sınıra dahil değildir, varsayılan limite tabidir. Bkz. Kuyruklar
/cdrs, /cdrs/{id}	dakikada 6 istek	–	Bkz. CDR
/ivr_campaigns	saniyede 2 istek (yaklaşık dakikada 120)	50	Bkz. IVR Kampanyaları
Diğer tüm endpoint'ler	saniyede 2 istek (yaklaşık dakikada 120)	10	Varsayılan limit

429 Hatası Alırsanız

İsteklerinizi belirtilen limitin üzerinde sıklıkta göndermeyin. Sınıra ulaşıldığında bir süre bekleyip (exponential backoff) tekrar deneyin. Yüksek hacimli entegrasyonlarda toplu işlemleri kuyruğa alıp limit dahilinde kademeli göndermeniz önerilir.