Geliştirici paneli inkiveta.com

Test ortamı

Canlı uygulamanı gerçek kullanıcıları etkilemeden, aynı anda test edebilirsin. Her uygulamanın iki ortamı vardır: gerçek ve test. İkisi tamamen ayrıdır.

Test token'ı ve yolu#

  • Her uygulamanın ayrı bir test token'ı vardır (uygulama oluşturulurken üretilir). Atölye → Anahtar'da ortamı Test seçerek görürsün.
  • İstek yolu: https://app.inkiveta.com/bot<test_token>/test/<YÖNTEM>
  • Dosya yolu: https://app.inkiveta.com/file/bot<test_token>/test/<file_path>
  • Test yolu yalnız test token'ıyla çalışır. Gerçek token'la /test/ yoluna gidersen 401 Unauthorized alırsın (ve tersi).
bashcurl -s "https://app.inkiveta.com/bot$TEST_TOKEN/test/getMe"

Kütüphanelerde#

KütüphaneAyar
python-telegram-bot (≥ 21.11).base_url("https://app.inkiveta.com/bot{token}/test").base_file_url("https://app.inkiveta.com/file/bot{token}/test")
aiogram 3TelegramAPIServer(base="https://app.inkiveta.com/bot{token}/test/{method}", file="https://app.inkiveta.com/file/bot{token}/test/{path}")
Telegraf 4{ telegram: { apiRoot: "https://app.inkiveta.com", testEnv: true } }
grammY{ client: { apiRoot: "https://app.inkiveta.com", environment: "test" } }

İpucu: Token'ı ve ortamı ortam değişkeninden oku (BOT_TOKEN, BOT_ORTAM=test). Aynı kod iki ortamda da çalışır; yalnız ayar değişir.

Kimler görür?#

  • Sen, ekibin ve Atölye → Test'ten eklediğin hesaplar.
  • Test sohbeti uygulamada "Test" rozetli ayrı bir satırdır: mesaj geldiğinde Sohbetler listesinde görünür, ayrıca Keşfet → Uygulamaların'da durur.
  • Test kullanıcısı olmayan biri test ortamını göremez; test ortamı aramada ve Keşfet'te çıkmaz.

Neler ayrıdır?#

Update kuyruğu, webhook, file_id'ler, callback'ler, faturalar, ödemeler, abonelikler, komutlar, profil ve Mini App adresi ortam başınadır. Test ortamında oluşan hiçbir şey gerçek ortama geçmez; test file_id'sini gerçek ortamda kullanamazsın.

Test Ink#

Her uygulamanın 10.000 test Ink'lik ayrı bir cüzdanı vardır; Atölye → Test'ten sıfırlarsın. Ödemeler gerçek ortamda henüz açılmamış olsa bile test ortamında tüm ödeme akışı çalışır ve kendi test uygulamandan alışveriş yapabilirsin. Gerçek Ink'e hiç dokunulmaz.

Olay simülatörü#

Atölye → Test'te tek tıkla şu olayları üretebilirsin:

  • ödeme başarılı / ödeme reddedildi / iade isteği
  • kullanıcı engelledi
  • bildirim sıklığı değişti
  • veri silme isteği (request_id = 0; onayı test ortamında true döner)

"Sıklık değişti" olayı gerçek ortamdakiyle aynı biçimdedir: my_chat_member (member → member) ve uzantı alanı inki_frequency: {"old":"all","new":"digest"} (all = her an, important = yalnız önemli, digest = günlük özet). allowed_updates listende my_chat_member yoksa gelmez.

Test ortamında olmayan kapılar#

  • Barındırma ülkesi beyanı ve yurt dışı aktarım sözleşmesi test ortamında aranmaz — sunucun neredeyse orada deneyebilirsin. Gerçek ortama geçmeden önce Gizlilik adımlarını tamamla.
  • Akış editöründe test ortamı son kaydedilmiş taslağı, gerçek ortam yayınlanan sürümü çalıştırır.