Mini App Tester ile Telegram Mini App'lerin JavaScript API'sini (Telegram.WebApp) kod yazmadan test edebilirsiniz. Normal bir tarayıcıda mock modunda çalışır ve API'yi emüle eder; Telegram içinde açıldığında o anki istemcinin gerçek API'sini kullanır. Telegram Mini App nasıl yapılır diye araştırıyorsanız bir özelliği kodlamadan önce burada deneyebilir ya da belirli bir istemcinin nasıl davrandığını görebilirsiniz.
Telegram.WebApp nesnesini emüle eder.https://telegram-bot-api.info/telegram-mini-app-tester.html adresini girin (/newapp ya da menü düğmesi ayarları). Hosting gerekmez; arayüz kullanıcının Telegram diline uyum sağlar.version, platform, colorScheme, initData, themeParams ve güvenli alan (safe area) değerlerini karşılaştırın.Araç 13 metot grubu sunar:
ready, expand, close, başlık ve arka plan renkleri.showPopup, showAlert, showConfirm ve QR tarayıcı.openInvoice, shareToStory, emoji durumu, tam ekran ve downloadFile.Olay günlüğü themeChanged, viewportChanged, mainButtonClicked ve fullscreenChanged gibi 45+ olayı zaman damgasıyla kaydeder; böylece handler'larınıza tam olarak ne geleceğini görürsünüz.
Mini App'lerin ilk adı Web App olduğu için API nesnesi hâlâ Telegram.WebApp adını taşır. Mock modu arayüz ve akış içindir: hangi çağrıların bulunduğunu, ne döndürdüklerini ve hangi olayların tetiklendiğini gösterir, depolamayı localStorage'da emüle eder. İstemcinin yerel açılır pencerelerini, titreşimi ya da gerçek kullanıcı verisini üretemez; initData da Telegram'ın imzalamadığı bir örnektir. Telegram içinde araç gerçek API'ye geçer: initData gerçektir ve her çağrı istemciye ulaşır. Bu veriyi sunucunuzda mutlaka HMAC-SHA256 ile doğrulayın.
/newbot ile bir bot açın ve bot token'ını alın./newapp ile t.me/<bot>/<app> biçiminde doğrudan bağlantı oluşturun ya da bot ayarlarından menü düğmesini yapılandırın. Klavyedeki web_app düğmeleri ve inline düğmeler de Mini App açabilir.Test aracı tamamen tarayıcınızda çalışır, bot token'ı istemez ve Bot API'yi çağırmaz. Mock depolama verileri tarayıcınızın localStorage alanında kalır.
Menü düğmesini API üzerinden Mini App'inize yönlendirmek için Bot API Tester içinde setChatMenuButton metodunu çağırın; düğmeyi tek bir özel sohbet için değiştirecekseniz chat ID nasıl bulunur rehberine bakın. Mini App'i bir mesajdaki inline düğmeyle açmak için Bot API ile mesaj gönderme rehberindeki reply_markup örneklerinden yararlanın. Metotların ayrıntıları Swagger sayfasında ve metot referansında yer alır.
Mini App Tester'ı herhangi bir tarayıcıda açın. Mock modu Telegram.WebApp nesnesini emüle eder; bot ya da Telegram istemcisi olmadan metotları çağırabilir, olayları tetikleyebilir ve özellikleri inceleyebilirsiniz.
Mini App, Telegram içinde açılan bir web sayfasıdır ve Telegram.WebApp JavaScript API'sini kullanır. @BotFather'da bir bot oluşturun, sayfayı HTTPS üzerinden yayınlayın ve /newapp komutuyla ya da menü düğmesi ayarlarından bota bağlayın.
Evet. @BotFather'da /newapp ile ya da menü düğmesi ayarlarından Mini App URL'si olarak https://telegram-bot-api.info/telegram-mini-app-tester.html adresini girin. Telegram içinde gerçek WebApp API'si kullanılır ve hosting gerekmez.
WebApp temel metotları, MainButton, SecondaryButton, BackButton ve SettingsButton, açılır pencereler, HapticFeedback, CloudStorage, DeviceStorage, SecureStorage, sensörler, biyometri, konum, izinler, fatura ve hikayeler, emoji durumu, tam ekran ve dosya indirme; ayrıca 45+ olayın günlüğü.
Hayır. Mock modu, Telegram'ın hiç imzalamadığı örnek veriler kullanır; bu yüzden HMAC doğrulamasından bilerek geçmez. Sunucu tarafındaki doğrulamanızı test etmek için aracı Telegram içinde açıp gerçek initData alın.
Hayır. Sayfa Bot API'yi hiç çağırmaz. Bota yalnızca test aracını Telegram içinde Mini App olarak açmak istiyorsanız ihtiyacınız olur.