Telegram Stars API: Fragment bilan qanday ishlaydi?

Kirish

StarsPaymee API — Telegram Stars va Premium yetkazish uchun maxsus ishlab chiqilgan REST xizmati. Lekin bu faqat oddiy proxy emas — ichida juda ko'p tekshiruvlar va kafolatlar mavjud.

Arxitektura: 3 qatlam

Tizim uchta asosiy komponentdan iborat:

1. Next.js API (Public Layer)

Mijozlar faqat shu qatlam bilan muloqot qiladi. Bu qatlam:

2. Fragment Service (Python FastAPI)

Bu qatlam to'g'ridan-to'g'ri Fragment Protocol bilan gaplashadi:

3. Fragment Protocol (TON Blockchain)

Haqiqiy yetkazish bu yerda sodir bo'ladi. Har bir tranzaksiya TON blockchain'da tasdiqlangan.

Xavfsizlik modeli

Next.js API Fragment Service ning URL'ini va secret kalitini biladi, lekin hech qachon Fragment cookie yoki TON seed ni ko'rmaydi. Bu ikki tizimni ajratish xavfsizlikni oshiradi — agar Next.js hujumga uchrasa, Fragment cookie xavfsiz qoladi.

Idempotency kafolati

Har buyurtmaga idempotency_key bering:

{
  "username": "durov",
  "stars": 500,
  "idempotency_key": "unique-order-id-123"
}

Agar tarmoq uzilsa va qayta so'rov yuborsangiz — pul ikki marta yechilmaydi. Bir xil kalit bilan qayta so'rov yuborsangiz, avvalgi natija qaytariladi.

Xulosa

StarsPaymee API — ishonchli, tez va xavfsiz yetkazish infratuzilmasi. Fragment'ning barcha imkoniyatlarini oddiy REST API orqali taqdim etadi.