Telegram mini app yaratish
Telegram mini app yaratish: mini ilova bu Telegram ichida ochiladigan oddiy veb-sayt bo'lib, u bot bilan bog'langan. Agar HTML, CSS va JavaScript bilsangiz, mini app yarata olasiz. Telegram sahifaga foydalanuvchi ma'lumotlari, mavzu ranglari, tugmalar va to'lovlar uchun JavaScript API beradi. Ushbu maqolada mini app qanday tuzilganini, bot va veb-ilovani qanday bog'lashni, Telegram Web App API asoslarini, Stars orqali to'lovlarni, konstruktorlar va tayyor shablonlarni hamda xavfsizlik uchun eng muhim qadamni oddiy tilda tushuntiramiz.
Telegram API va mini ilova imkoniyatlari tez-tez yangilanadi. Metod nomlari va cheklovlarni har doim rasmiy hujjatlardan tekshiring.
Mini app qanday tuzilgan
Mini app uch qismdan iborat: bot, HTTPS orqali ochiladigan veb-sahifa va ixtiyoriy backend server. Foydalanuvchi botdagi tugmani bosganda Telegram sahifani o'z ichidagi brauzerda ochadi va unga foydalanuvchi haqidagi imzolangan ma'lumotni uzatadi. Sahifa oddiy veb-sayt kabi ishlaydi, faqat Telegram interfeysi bilan bog'lanish uchun maxsus skriptdan foydalanadi. Mini ilovalar nima ekanligi haqida umumiy ma'lumot: Telegram mini ilovalar.
Bot va veb-ilovani bog'lash
- @BotFather orqali yangi bot yarating va tokenni saqlang.
- Veb-sahifangizni HTTPS bilan ishlaydigan hostingga joylashtiring.
- BotFather'da sahifa manzilini botning mini ilovasi yoki menyu tugmasi sifatida ko'rsating.
- Botni oching va tugmani bosib, sahifa Telegram ichida ochilishini tekshiring.
Shundan keyin mini ilovani bot profilidan, inline tugmadan yoki to'g'ridan-to'g'ri havoladan ochish mumkin.
Telegram Web App API asoslari
| Imkoniyat | Nima uchun |
|---|---|
| telegram-web-app.js skripti | Telegram bilan aloqa uchun asosiy obyekt beradi |
| ready() va expand() | Sahifa tayyorligini bildirish va to'liq ekranga yoyish |
| themeParams | Foydalanuvchi mavzusiga mos ranglar |
| MainButton va BackButton | Telegram interfeysidagi asosiy va orqaga tugmalari |
| initData | Foydalanuvchi va sessiya haqidagi imzolangan ma'lumot |
Hujjatlarda yana haptik javob, bulutli saqlash, ulashish va boshqa ko'plab funksiyalar tasvirlangan. Ularni rasmiy «Telegram Mini Apps» hujjatidan o'rganing.
To'lovlar va Stars
Telegram ichida raqamli tovar va xizmatlar sotilsa, to'lov Telegram Stars orqali amalga oshirilishi kerak. Bot Stars valyutasida hisob-faktura yaratadi, mini ilova uni ochadi, Telegram esa to'lovni qabul qilib, botga xabar beradi. Ishlab chiquvchi yig'ilgan Stars'ni keyinchalik Telegram qoidalariga ko'ra almashtirishi mumkin. Batafsil: Telegram Stars. Foydalanuvchining shaxsiy TON hamyonini ulash uchun esa TON Connect ishlatiladi.
Konstruktorlar va tayyor shablonlar
Agar dasturlashni bilmasangiz, oddiy do'kon yoki forma uchun kodsiz mini app konstruktorlari bor, lekin ularning imkoniyatlari cheklangan va ko'pincha oylik to'lov talab qiladi. Dasturchilar uchun GitHub'da React, Vue va boshqa freymvorklar asosidagi tayyor shablonlar mavjud: ularda skript ulanishi, mavzu va TON Connect allaqachon sozlangan bo'ladi. Shablondan boshlash vaqtni tejaydi, ammo kodni tushunmasdan ishlatmang.
Xavfsizlik: initData tekshiruvi
Serverda hech qachon foydalanuvchi ma'lumotiga ko'r-ko'rona ishonmang. Mini ilova initData qatorini backendga yuborishi, server esa uni bot tokeni yordamida HMAC-SHA256 bilan tekshirishi kerak. Shuningdek, auth_date juda eski bo'lsa, so'rovni rad eting. Faqat shu tekshiruvdan keyin foydalanuvchi ID'si haqiqiy deb hisoblanadi va mukofot yoki ruxsat beriladi. Bot tokenini hech qachon front-end kodiga qo'ymang, chunki sahifa kodini istalgan foydalanuvchi ko'ra oladi.
Mini ilova namunasi
TotalHash Telegram mini ilovasi sifatida ishlaydigan bepul mayning o'yini. Vazifalar TON hamyoniga kichik miqdorda USD₮ va GRAM yuboradi. Daromad va'da qilinmaydi.
Telegram'dagi bepul o'yin.
TotalHash'ni ochishQisqa javoblar
Telegram mini app nima?
Bot bilan bog'langan va Telegram ichida ochiladigan veb-sahifa.
Telegram mini app hujjatlari qayerda?
Telegram'ning rasmiy dasturchilar saytidagi Mini Apps bo'limida.
Mini app'da to'lov qanday qilinadi?
Raqamli tovarlar uchun Telegram Stars orqali.
Kodsiz mini app yaratish mumkinmi?
Ha, konstruktorlar bor, lekin imkoniyatlari cheklangan.