Validator initData Telegram Mini App
Tempel Telegram.WebApp.initData dan token bot kamu untuk mengecek apakah hash Mini App valid — pengecekan HMAC-SHA256 yang sama dengan yang wajib dijalankan server kamu, dilakukan secara lokal di browser.
Token tetap di browser kamu (localStorage) dan hanya dikirim ke api.telegram.org.
Algoritma: secret_key = HMAC_SHA256("WebAppData", bot_token); hash = hex(HMAC_SHA256(secret_key, data_check_string)), dengan data_check_string berisi semua field kecuali hash, diurutkan berdasarkan key dan digabung sebagai key=value dengan \n.
Cara mengecek hash Telegram Mini App
- Ambil string initData mentah di Mini App kamu, misalnya dengan mencetak
Telegram.WebApp.initDatake log (bukaninitDataUnsafe). Fragmen URL yang diawalitgWebAppData=juga bisa: awalannya akan dihapus. - Tempel token bot yang membuka Mini App tersebut.
- Tekan Validasi. Kamu mendapat hasil valid/tidak valid,
auth_datebeserta umurnya (dengan peringatan jika lebih lama dari 24 jam), dan semua field hasil parsing, denganuserdan nilai JSON lainnya sudah di-decode.
Cara kerja validasi
Alat ini mengikuti algoritma resmi dari Validating data received via the Mini App:
- Parse initData sebagai query string dan sisihkan
hash. - Susun
data_check_string: semua field lainnya sebagaikey=value(nilai sudah di-URL-decode), diurutkan secara alfabetis, digabung dengan karakter baris baru\n. secret_key = HMAC_SHA256(key="WebAppData", message=bot_token).- Data valid jika
hex(HMAC_SHA256(key=secret_key, message=data_check_string))sama denganhash.
Pengecekan yang sama di server Node.js:
const crypto = require('crypto');
function checkInitData(initData, botToken) {
const params = new URLSearchParams(initData);
const hash = params.get('hash');
params.delete('hash');
const dataCheckString = [...params]
.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
.map(([k, v]) => `${k}=${v}`)
.join('\n');
const secret = crypto.createHmac('sha256', 'WebAppData').update(botToken).digest();
const calc = crypto.createHmac('sha256', secret).update(dataCheckString).digest('hex');
return calc === hash;
}
Cek juga auth_date di server agar initData lama yang disadap tidak bisa dipakai ulang.
Kenapa hash tidak cocok
- Token berasal dari bot yang berbeda dengan bot yang membuka Mini App.
- initData di-decode atau diubah sebelum divalidasi — selalu kirim string mentahnya.
- String disusun ulang dari
initDataUnsafe: urutan field dan encoding-nya berbeda, jadi hash tidak akan cocok.
Privasi
Tidak ada request yang keluar dari browser kamu: HMAC dihitung dengan Web Crypto API, dan token hanya disimpan di localStorage — tidak ada yang sampai ke server kami. Untuk melihat initData asli dari peluncuran sungguhan, buka /id/telegram-mini-app-tester.html di dalam Telegram. Alur pengujian lengkapnya ada di /id/guides/test-telegram-mini-app.html; jika kamu butuh token baru, lihat /id/guides/telegram-bot-token.html.
Pertanyaan umum
Bagaimana cara memvalidasi init data Telegram Web App?
Hitung secret_key = HMAC_SHA256("WebAppData", bot_token), susun data-check-string dari semua field kecuali hash yang diurutkan berdasarkan key dan digabung dengan \n, lalu bandingkan hex(HMAC_SHA256(secret_key, data_check_string)) dengan hash. Alat di atas melakukan persis hal ini.
Kenapa hash initData saya tidak valid?
Biasanya token milik bot lain, atau initData sudah diubah: di-decode, di-encode ulang, dipotong, atau disusun ulang dari initDataUnsafe. Tempel string Telegram.WebApp.initData mentah.
Apakah initDataUnsafe bisa dipercaya?
Tidak di server. initDataUnsafe hanyalah data hasil parsing di sisi klien; kirim initData mentah ke backend dan validasi hash di sana sebelum memercayai ID pengguna.
Berapa lama initData boleh berumur?
Telegram menyarankan mengecek auth_date untuk menolak data yang kedaluwarsa, tetapi batasnya kamu tentukan sendiri. Alat ini menampilkan umur data dan memberi peringatan jika data lebih lama dari 24 jam.
Apakah token bot saya dikirim ke suatu tempat?
Tidak. Validator ini tidak membuat request jaringan: hash dihitung dengan Web Crypto API di browser kamu. Token hanya diingat di localStorage.
Utilitas lainnya
Pencari Chat IDEscaper MarkdownV2 & HTMLPemeriksa webhookBot API Tester