Limitler
Hız#
| Konu | Sınır |
|---|---|
| Genel gönderim | Uygulama + ortam başına saniyede 30 istek (gönderme, düzenleme, sohbet eylemi, sorgu yanıtı, ana sayfa / hızlı eylem yazımı; webhook yanıtındaki ve akıştaki gönderimler dahil) |
| Sohbet başına | 3 saniyede 3 mesaj (kısa patlamaya izin verir, ortalama ~1/sn) |
| Canlı bileşen | Bileşen başına saniyede 1 güncelleme |
| Aşım | 429 Too Many Requests: retry after N; parameters.retry_after = N saniye |
json{"ok":false,"error_code":429,"description":"Too Many Requests: retry after 3","parameters":{"retry_after":3}}
İpucu: Çok kullanıcıya duyuru gönderiyorsan kuyruk kullan ve saniyede 25 civarında tut. python-telegram-bot'ta
AIORateLimiter, grammY'de@grammyjs/auto-retry429'u kendiliğinden yönetir.
Boyutlar#
| Konu | Sınır |
|---|---|
| Mesaj metni | 4.096 karakter (UTF-16 birimi; MessageEntity.offset/length da UTF-16) |
| Başlık (caption) | 1.024 |
callback_data | 1–64 bayt |
| Yükleme | Fotoğraf 10 MB, diğer dosyalar 50 MB |
| URL ile gönderim | Fotoğraf 5 MB, diğer 20 MB; URL ile document yalnız PDF/ZIP/GIF, voice yalnız OGG ≤ 1 MB |
getFile ile indirme | 20 MB |
| Bileşen | 32 KiB; fallback_text ≤ 4.096; toast ≤ 200 |
| Widget | HTML ≤ 32.768 bayt, sıkıştırılmış ≤ 4.096 bayt, veri ≤ 1.024 bayt |
| Komutlar | ≤ 100, ad ^[a-z0-9_]{1,32}$ |
| Hızlı eylem | 1–6 |
| Ana sayfa | ≤ 6 karo, ≤ 4 bölüm, ≤ 8 öneri çipi |
Süreler#
| Konu | Sınır |
|---|---|
callback_query yanıtı | 10 sn |
inki_component_action yanıtı | 10 sn |
pre_checkout_query yanıtı | 10 sn |
widget_query yanıtı | 15 sn |
answerWebAppQuery | 24 saat |
| Kullanıcı yazmadan yazma penceresi | 24 saat (kullanıcı tercihi kapalıysa — kurallar) |
Webhook ve yoklama#
| Konu | Sınır |
|---|---|
| Webhook bağlantısı | 3 sn bağlanma, toplam 30 sn |
| Webhook yanıt gövdesi | 1 MB |
max_connections | 1–100 (varsayılan 40) |
| Webhook yanıtında yöntem | Hemen çalışan: 5 sn; medya/dosya içeren: kuyrukta, istek başına 10 sn, en çok bir deneme, 1 saat içinde |
| Teslim edilemeyen update | 24 saat sonra düşer; yeniden deneme aralığı 1 sn'den 1 saate kadar büyür |
getUpdates | limit 1–100, timeout ≤ 50 sn, uygulama + ortam başına aynı anda tek yoklama |
Akış editörü#
| Konu | Sınır |
|---|---|
| Akış | ≤ 200 düğüm, ≤ 400 bağlantı, ≤ 20 başlangıç |
| Adım | 5 sn; tek çalıştırmada ≤ 100 adım |
| Bağlantı düğümü | 3 sn, yanıt ≤ 256 KB (değişkene ≤ 16 KB), gövde şablonu ≤ 8 KB, uygulama başına saniyede 10 |
| Bekle | 1 sn – 7 gün |
Damla aramaları#
| Konu | Sınır |
|---|---|
| Arama | Aynı kullanıcıya günde 1 / 7 günde 3, uygulama başına günde 200 arama, kullanıcının saatiyle 09:00–20:00 (pazar ve resmî tatil yok), görüşme 30–180 sn — ayrıntı: Damla aramaları |
| Ücret | 1 dk = 5,00 TL (başlayan dakika), bağlanmayan arama ücretsiz; bakiye yalnız dakika paketiyle |
Mini App bildirimleri#
| Konu | Sınır |
|---|---|
| Bildirim (kayan 24 saat) | Aynı kullanıcıya islem 20 · hatirlatma 3 · tanitim 1; uygulama geneli 10.000 (doğrulanmış 100.000, test 200) — ayrıntı: Mini App bildirimleri |
| Metin | Başlık 40, gövde 140 karakter; start_param 64 |
| Kategori | En çok 8; tür sonradan değişmez |
Oyun odaları#
| Konu | Sınır |
|---|---|
| Açık oda (aynı anda) | Test ortamı 20 · gerçek 200 · doğrulanmış uygulama 2.000 |
| Oda açma | Saniyede 1 · 5 · 20; kayan 24 saatte 500 · 20.000 · 200.000 (test · gerçek · doğrulanmış) |
| Koltuk | Oda başına 1–8 oyuncu (relay en az 2) + 1 hakem; kişi başına açık koltuk 5 (aynı uygulamada 2) |
| Bilet | 30 saniye, tek kullanım; kişi başına dakikada 30, hakem bileti uygulama başına dakikada 60 |
| İleti | Oyuncu ≤ 4.096 bayt, saniyede 20 (tepe 60); hakem ≤ 16.384 bayt, saniyede 100 (tepe 200) |
| Oda | Saniyede 60 yayın olayı, saniyede 512 KiB çıkış; boşta 30–600 sn (varsayılan 120), ömür 4 saat — ayrıntı: Oyun odaları |
Ödemeler#
| Konu | Sınır |
|---|---|
| Fatura tutarı | 1–10.000 Ink, tek fiyat kalemi |
| Ücretli medya | 1–10.000 Ink, ≤ 10 öğe |
| Abonelik dönemi | 30 gün (2.592.000 sn) |
| Kazanç bekleme | 14 gün |
getStarTransactions | offset ≤ 5.000 |