Hız sınırları

Bot isteklerinin sınırları tek yerde, bu sayfada yazılıdır. Sınırı aşan istek 429 alır. Yanıttaki bekleme süresine uyan bir bot sorun yaşamaz.

Rota sınıfları

Her bot rotası bir sınıfa aittir. Rotanın sınıfı REST referansında yazar.

Sınır şunların her biri için ayrı sayılır: bot, rota ve kanal. Rotada kanal yoksa kanal yerine sunucu sayılır; ikisi de yoksa yalnızca bot ve rota. Örneğin iki ayrı kanala aynı anda 5'er mesaj gönderebilirsin.

Genel sınır

Bir bot, tüm rotalar toplamında saniyede en çok 50 istek gönderebilir. Aşınca X-RateLimit-Scope: global ile 429 alır.

Tüm botların ortak tavanı

Tüm botlar birlikte saniyede en çok 70 yazma (read dışındaki her sınıf) yapabilir; ayrıca aynı anda en çok 8 bot isteği (okuma dahil) çalışır. Etkileşim yanıtında yalnızca kanala mesaj yazanlar yazma sayılır:

Aynı anda 8 istek sınırına bunların hepsi girer. Biri aşılırsa bot X-RateLimit-Scope: shared ile 429 alır; yanıtta retry_after ve Retry-After bulunur (eşzamanlılık sınırında 1 saniye). Bu 429 botunun suçu değildir: geçersiz istek sayılmaz ve geçici engele yol açmaz. retry_after kadar bekleyip isteği yeniden gönder.

Etkileşimleri HTTP ile alıyorsan adresinin 200 yanıtı da bu tavanlara, interaction sınıfına ve yayılma bütçesine aynen sayılır; bir callback çağrısı gibi. Tavan doluysa yanıt yazılmaz ve kişi 429 interaction_busy görür. Bu da botunun suçu olmayabilir: başka botlar tavanı doldurmuş olabilir. Teslim günlüğünde sonuç busy olur ve devre kesiciye sayılmaz. Tekrar deneme yoktur; kişi isterse yeniden çalıştırır.

Embed ve bileşenlerin yayılma bütçesi

Bir mesaj, kanaldaki herkese ayrı ayrı gönderilir; embed ve bileşenler mesajı büyütür. Bu yüzden her mesajın embed ve bileşenleri (metin sayılmaz) sunucunun üye sayısıyla (DM'de kişi sayısıyla) çarpılır ve tüm botlarla webhook'ların paylaştığı saniyelik bir bütçeden (700000 bayt) düşer:

Maliyeti payından büyük olan mesaj büyük mesajdır. Ardından bir sonraki büyük mesajın için, her sunucuda, mesajın ödenmesi için gereken sürenin dört katı beklersin; o sunucuya da o süre hiçbir bot büyük mesaj gönderemez: sana X-RateLimit-Scope: bot, sunucu için shared ile 429 gelir. Havuzdan (bütçe eksi yedek, saniyede 630000 bayt) fazla tutan büyük mesaj o saniyede kalanı alır, sonra o ve o saniyenin önceden harcadığı ödenene kadar tüm botların sayılan diğer mesajları bekler: 600 kişilik bir sunucuya 32 KiB'lık bir mesaj onları yaklaşık 31 saniye bekletir, hiçbir bekletme yaklaşık 34 saniyeden uzun sürmez. Aynı anda tek bekletme olur. Bütçe dolu ya da bekletmedeyken bot X-RateLimit-Scope: shared ile 429 alır. Bu 429 botunun suçu değildir: geçersiz istek sayılmaz ve geçici engele yol açmaz. bot kapsamlı 429 ise senindir ve diğer sınırların gibi sayılır. retry_after ne kadar bekleyeceğini söyler. Düzenleme istekleri ve webhook'la gönderilen embed'ler de aynı bütçeyi kullanır.

Özel mesajlar

Botunun DM'lerde kendiliğinden yazdıkları (mesaj, tepki, sabitleme, yazıyor) tüm DM'leri toplamında ayrıca sayılır:

Aşınca X-RateLimit-Scope: bot ile 429 alırsın. retry_after kadar bekleyip yeniden gönder. message sınıfının kanal başına sınırı DM'de de geçerlidir.

Başlıklar

Bot isteklerinin yanıtlarında şu başlıklar gelir:

X-RateLimit-Bucket bir rotanın tüm kanallarında aynıdır ama Remaining kanal başına sayılır. Bu yüzden sınırı izlerken kovayı kanal veya sunucu ID'siyle birlikte tut.

Genel sınıra takılan yanıtta yalnızca X-RateLimit-Scope ve Retry-After gelir. Sınır sistemi geçici olarak çalışmıyorsa istekler sınırlanmaz ve bu başlıklar hiç gelmez; kodun bu başlıkların her zaman var olduğunu varsaymasın.

429 yanıtı

HTTP/1.1 429 Too Many Requests
Retry-After: 2
X-RateLimit-Scope: bot
X-RateLimit-Limit: 5
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1793966400.250
X-RateLimit-Reset-After: 1.250
X-RateLimit-Bucket: 3f9a1c7e5b2d4860
Content-Type: application/json; charset=utf-8

{"code":"rate_limited","message":"You are being rate limited.","retry_after":1.25}

• retry_after, gövdede beklenecek süredir; saniye cinsinden, üç ondalığa kadar.
• Retry-After, başlıktaki aynı süredir; yukarı yuvarlanmış tam saniye.
• X-RateLimit-Scope, sınıf sınırında bot, genel sınırda global, yukarıdaki tavanda shared olur. Aşağıdaki ek sınırlarda bu başlık gelmez.

Beklemeden tekrar denemek işe yaramaz; aşağıdaki gibi süreyi bekle:

if (res.status === 429) {
  const { retry_after } = await res.json();
  await new Promise((done) => setTimeout(done, retry_after * 1000));
  // sonra isteği yeniden gönder
}

Ek sınırlar

Bazı işlemlerde sınıf sınırına ek olarak şu sınırlar da geçerlidir. Bunlar da 429 verir ve retry_after içerir.

ManageMessages veya ManageChannels iznine sahip olanlar yavaş moddan muaftır.

Portaldaki uygulama işlemlerinin de sınırı vardır: uygulama oluşturma ve token yenileme için hesap başına, bot resmini yükleme ve kaldırma için bot başına 10 dakikada 5 işlem.

Gateway sınırları

Gateway bağlantısının sınırları REST'ten ayrıdır:

Resume oturum başlatma sayılmaz. Kalan başlatma hakkını GET /gateway/bot gösterir.

Geçersiz istekler ve geçici engel

Bir IP adresinden Bot şemasıyla gönderilen ve reddedilen (401, 403 veya 429 alan) istekler sayılır. Sayı 10 dakika içinde 10000'e ulaşırsa, o adresten gelen Bot şemalı tüm istekler pencere bitene kadar reddedilir, geçerli token'lar dahil:

{"code":"temporarily_banned","message":"Too many invalid requests. Try again later.","retry_after":312.5}

Yanıt 403'tür ve Retry-After başlığı içerir. Aynı adresten siteyi ve uygulamayı kullanan kişiler bundan etkilenmez.

Bundan kaçınmak için: 401 alınca isteği tekrarlamak yerine botu durdur, 403 alan isteği aynen tekrarlama ve 429 alınca süreyi bekle.

Bu sayfayı yapay zekaya verirsen

Sırada ne var

• JavaScript kütüphanesi ve Python kütüphanesi: otomatik kova kuyruğu ve Retry-After yönetimi
• Hatalar: rate_limited, slowmode ve upload_quota kodları
• Güvenlik: geçersiz istek engelinden kaçınma ve güvenli çalışma