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 gidersen401 Unauthorizedalırsın (ve tersi).
bashcurl -s "https://app.inkiveta.com/bot$TEST_TOKEN/test/getMe"
Kütüphanelerde#
| Kütüphane | Ayar |
|---|---|
| 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 3 | TelegramAPIServer(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ındatruedö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.