Geliştirici paneli inkiveta.com

Limitler

Hız#

KonuSınır
Genel gönderimUygulama + 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şına3 saniyede 3 mesaj (kısa patlamaya izin verir, ortalama ~1/sn)
Canlı bileşenBileşen başına saniyede 1 güncelleme
Aşım429 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-retry 429'u kendiliğinden yönetir.

Boyutlar#

KonuSınır
Mesaj metni4.096 karakter (UTF-16 birimi; MessageEntity.offset/length da UTF-16)
Başlık (caption)1.024
callback_data1–64 bayt
YüklemeFotoğraf 10 MB, diğer dosyalar 50 MB
URL ile gönderimFotoğraf 5 MB, diğer 20 MB; URL ile document yalnız PDF/ZIP/GIF, voice yalnız OGG ≤ 1 MB
getFile ile indirme20 MB
Bileşen32 KiB; fallback_text ≤ 4.096; toast ≤ 200
WidgetHTML ≤ 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ı eylem1–6
Ana sayfa≤ 6 karo, ≤ 4 bölüm, ≤ 8 öneri çipi

Süreler#

KonuSı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
answerWebAppQuery24 saat
Kullanıcı yazmadan yazma penceresi24 saat (kullanıcı tercihi kapalıysa — kurallar)

Webhook ve yoklama#

KonuSınır
Webhook bağlantısı3 sn bağlanma, toplam 30 sn
Webhook yanıt gövdesi1 MB
max_connections1–100 (varsayılan 40)
Webhook yanıtında yöntemHemen çalışan: 5 sn; medya/dosya içeren: kuyrukta, istek başına 10 sn, en çok bir deneme, 1 saat içinde
Teslim edilemeyen update24 saat sonra düşer; yeniden deneme aralığı 1 sn'den 1 saate kadar büyür
getUpdateslimit 1–100, timeout ≤ 50 sn, uygulama + ortam başına aynı anda tek yoklama

Akış editörü#

KonuSınır
Akış≤ 200 düğüm, ≤ 400 bağlantı, ≤ 20 başlangıç
Adım5 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
Bekle1 sn – 7 gün

Damla aramaları#

KonuSınır
AramaAynı 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ı
Ücret1 dk = 5,00 TL (başlayan dakika), bağlanmayan arama ücretsiz; bakiye yalnız dakika paketiyle

Mini App bildirimleri#

KonuSı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
MetinBaşlık 40, gövde 140 karakter; start_param 64
KategoriEn çok 8; tür sonradan değişmez

Oyun odaları#

KonuSınır
Açık oda (aynı anda)Test ortamı 20 · gerçek 200 · doğrulanmış uygulama 2.000
Oda açmaSaniyede 1 · 5 · 20; kayan 24 saatte 500 · 20.000 · 200.000 (test · gerçek · doğrulanmış)
KoltukOda başına 1–8 oyuncu (relay en az 2) + 1 hakem; kişi başına açık koltuk 5 (aynı uygulamada 2)
Bilet30 saniye, tek kullanım; kişi başına dakikada 30, hakem bileti uygulama başına dakikada 60
İletiOyuncu ≤ 4.096 bayt, saniyede 20 (tepe 60); hakem ≤ 16.384 bayt, saniyede 100 (tepe 200)
OdaSaniyede 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#

KonuSınır
Fatura tutarı1–10.000 Ink, tek fiyat kalemi
Ücretli medya1–10.000 Ink, ≤ 10 öğe
Abonelik dönemi30 gün (2.592.000 sn)
Kazanç bekleme14 gün
getStarTransactionsoffset ≤ 5.000