Hız Sınırlaması

Chainabit API, adil kullanımı sağlamak ve kötüye kullanıma karşı korumak için tüm uç noktalarda hız sınırları uygular. Sınırlar, kimliği doğrulanmış her kullanıcı için uç nokta başına uygulanır.

Genel Varsayılan

Belirli bir sınır yapılandırılmadıkça, tüm uç noktalar varsayılan bir hız sınırına tabidir:

Parametre	Değer
Requests (İstekler)	120
Window (Pencere)	60 saniye

Bu, kimliği doğrulanmış her kullanıcının belirli bir uç noktaya dakikada en fazla 120 istek yapabileceği anlamına gelir.

Kimlik Doğrulama Uç Noktası Sınırları

Kimlik doğrulama uç noktaları, kaba kuvvet saldırılarına karşı koruma sağlamak için daha sıkı sınırlara sahiptir:

Uç Nokta (Endpoint)	Sınır (Limit)	Pencere (Window)
POST /auth/register	10 istek	5 dakika
POST /auth/login	8 istek	60 saniye
POST /auth/resend-confirmation	5 istek	5 dakika
POST /auth/confirm-email	5 istek	5 dakika
POST /auth/forgot-password	3 istek	5 dakika
POST /auth/reset-password	5 istek	5 dakika
POST /auth/exchange-recovery-code	15 istek	5 dakika
GET /auth/check-username	20 istek	60 saniye
POST /auth/claim-username	5 istek	60 saniye
POST /auth/change-email	10 istek	60 saniye
POST /auth/change-password	10 istek	60 saniye

Diğer Belirli Sınırlar

Uç Nokta (Endpoint)	Sınır (Limit)	Pencere (Window)
POST /billing/checkout	5 istek	60 saniye
POST /mcp	60 istek	60 saniye

Hız Sınırı Hatalarını Yönetme

Hız sınırını aştığınızda, API HTTP 429 Too Many Requests (Çok Fazla İstek) ile yanıt verir:

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded"
  },
  "meta": {
    "requestId": "req_abc123",
    "durationMs": 1
  }
}

Önerilen İstemci Davranışı

1. Üstel geri çekilmeyi uygulayın. Bir 429 yanıtı aldığınızda, yeniden denemeden önce bekleyin. Ardışık her 429'da bekleme süresini iki katına çıkarın.
2. İstek hızınızı izleyin. Sınıra yaklaşıyorsanız, istekleri aniden toplu olarak göndermek yerine zamana yayın.
3. Yanıtları önbelleğe alın. Okuma yoğunluklu iş yükleri için, API çağrılarının sayısını azaltmak adına yanıtları istemci tarafında önbelleğe alın.

Örnek Geri Çekilme Stratejisi

Deneme 1: 1 saniye bekle
Deneme 2: 2 saniye bekle
Deneme 3: 4 saniye bekle
Deneme 4: 8 saniye bekle
(maksimum 30 saniye ile sınırlandırın)