Ana içeriğe geç

Hız Limitleri

SMSBAT, tüm kullanıcılar için yüksek performans ve güvenilirlik sağlamak amacıyla API isteklerine hız sınırlaması uygular. Hız sınırları, belirli bir zaman dilimi içinde yapabileceğiniz maksimum API çağrısı sayısını belirtir.

Varsayılan Limitler

Sözleşmenizde aksi belirtilmediği sürece, varsayılan hız sınırları tüm API uç noktalarına (SMSBAT API, Cascade API ve ChatHub API) uygulanır.

API Kategorisi Varsayılan Sınır Patlama Sınırı
Mesajlaşma Uç Noktaları (/bat/messagelist) 100 istek/saniye 150 istek / saniye
Veri Uç Noktaları (Durum, Bakiye, Bilgi) 50 istek/saniye 75 istek / saniye

[!NOT] Giden mesajlaşma için (örneğin, 'POST /bat/messagelist'), bir HTTP isteği 'mesajlar' dizisinde en fazla 5.000 mesaj içerebilir. Hız sınırı, gönderilen iletilerin sayısına değil, HTTP isteklerinin sayısına uygulanır.

İşlem Hızı Limitleri

İzin verilen oran sınırını aşarsanız API, HTTP '429 Çok Fazla İstek' durum koduyla yanıt verecektir.

Yanıt Örneği

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please wait before sending more requests.",
  "status": 429
}

En İyi Uygulamalar

Hız sınırlılığından kaçınmak için aşağıdaki en iyi uygulamaları göz önünde bulundurun:

  1. Mesajlarınızı Toplu Hale Getirin: 1.000 SMS mesajı için 1.000 ayrı HTTP isteği göndermek yerine, 1.000 nesneden oluşan bir dizi içeren tek bir istek gönderin.
  2. Üstel Gerilemeyi Uygulayın: '429' durum kodu alırsanız kısa bir süre bekleyin (ör. 1 saniye) ve tekrar deneyin. Tekrar başarısız olursa bekleme süresini iki katına çıkarın (2 saniye, 4 saniye, 8 saniye vb.).
  3. İsteklerinizi Hızlandırın: Binlerce API çağrısını tetikleyen otomatik bir komut dosyası çalıştırıyorsanız, istekler arasında küçük bir gecikme (ör. "sleep(10)" milisaniye) ekleyin.

Limit Artırımı Talebi

Kullanım durumunuz varsayılan sınırlardan daha yüksek bir aktarım hızı gerektiriyorsa artış talebinde bulunabilirsiniz.

  1. Özel hesap yöneticinizle iletişime geçin veya [email protected] adresine e-posta gönderin.
  2. Hesap Kimliğinizi ve beklenen verimi (ör. saniyede 500 istek) sağlayın.
  3. Kullanım durumunuzu kısaca açıklayın.

Teknik ekibimiz talebinizi inceleyecek ve limitlerinizi buna göre ayarlayacaktır.