API Hujjatlar — StarsUno.uz

Kirish

StarsUno API — o'z botingiz, saytingiz yoki ilovangizdan foydalanib Telegram Stars va Telegram Premium buyurtmalarini bevosita, real vaqtda amalga oshirish imkonini beruvchi interfeys.

Boshqa REST API'lardan farqli o'laroq, StarsUno API'ga so'rov yuborish uchun maxsus kutubxona yoki murakkab so'rov tuzilmasi kerak emas — barcha amallar oddiy GET so'rovi orqali, brauzer manziliga o'xshash URL shaklida amalga oshiriladi. Havolani ochish yetarli — javob JSON formatida qaytadi.

Autentifikatsiya

Har bir so'rovga manzil oxiriga key parametri sifatida shaxsiy API Hashingizni qo'shing. API Hashni bot ichidagi Hamkorlik → Hash Key bo'limidan olishingiz mumkin.

# Har qanday so'rovga qo'shiladigan parametr
?key=SIZNING_HASH_KALITINGIZ

Hash Key'ingizni ochiq forumlarda, front-end kodda yoki jamoat joylashgan havolalarda ulashmang — GET so'rovida kalit URL ichida ko'rinadi, shuning uchun uni faqat o'z serveringizdan chaqiring.

Bazaviy URL

https://starsuno.uz/

Barcha amallar tegishli yo'l (path) orqali chaqiriladi, autentifikatsiya esa key query parametri bilan amalga oshiriladi.

GETstars/price

Joriy Telegram Stars narxini (1 dona uchun) qaytaradi.

So'rov parametrlari

Parametr	Tur	Izoh
`key`	string	Sizning Hash Kalitingiz

https://starsuno.uz/stars/price?key=SIZNING_HASH_KALITINGIZ

Namuna Javob:

{
  "ok": true,
  "price": 250,
  "currency": "so'm"
}

GETpremium/price

Telegram Premium obunasi narxlarini muddatlar bo'yicha qaytaradi.

Parametr	Tur	Izoh
`key`	string	Sizning Hash Kalitingiz

https://starsuno.uz/premium/price?key=SIZNING_HASH_KALITINGIZ

Javob

{
  "ok": true,
  "prices": {
    "3": 170000,
    "6": 220000,
    "12": 390000
  },
  "currency": "so'm"
}

GETbalance

Hash Kalitingizga bog'langan hisobingizdagi joriy balansni qaytaradi.

Parametr	Tur	Izoh
`key`	string	Sizning Hash Kalitingiz

https://starsuno.uz/balance?key=SIZNING_HASH_KALITINGIZ

Javob

{
  "ok": true,
  "balance": 100000,
  "currency": "so'm"
}

GETstars/buy

Ko'rsatilgan foydalanuvchiga Telegram Stars'ni bevosita yuboradi — buyurtma yaratish/kutish bosqichisiz, javobning o'zida natija qaytadi.

So'rov parametrlari

Parametr	Tur	Izoh
`key`	string	Sizning Hash Kalitingiz
`username`	string	Stars yetkaziladigan foydalanuvchi (@ belgisisiz)
`amount`	integer	Sotib olinadigan Stars soni (50 - 10000)

So'rov manzili shunchaki quyidagicha ko'rinadi — buni brauzerda ham sinab ko'rishingiz mumkin:

https://starsuno.uz/stars/buy?key=SIZNING_HASH_KALITINGIZ&username=monk&amount=100

Muvaffaqiyatli javob

{
  "ok": true,
  "message": "Yulduz muvaffaqiyatli yuborildi!",
  "balance": 138000
}

Xato javob

{
  "ok": false,
  "code": "003",
  "error": "Hisobda mablag' yetarli emas"
}

GETpremium/buy

Ko'rsatilgan foydalanuvchiga Telegram Premium obunasini bevosita taqdim etadi.

Parametr	Tur	Izoh
`key`	string	Sizning Hash Kalitingiz
`username`	string	Premium taqdim etiladigan foydalanuvchi (@ belgisisiz)
`month`	integer	Premium muddati: `3`, `6` yoki `12`

https://starsuno.uz/premium/buy?key=SIZNING_HASH_KALITINGIZ&username=monk&month=12

Javob

{
  "ok": true
}

GETgift/buy

Ko'rsatilgan foydalanuvchiga Telegram Gift'ni bevosita yuboradi — buyurtma yaratish/kutish bosqichisiz, javobning o'zida natija qaytadi.

So'rov parametrlari

Parametr	Tur	Izoh
`key`	string	Sizning Hash Kalitingiz
`gift_id`	string	Yuborilishi kerak bo'lgan gift'ning ID raqami (quyidagi jadvalga qarang)
`username`	string	Gift yetkaziladigan foydalanuvchi (@ belgisisiz)
`text`	string	Izoh (ixtiyoriy, maksimal 200 belgi). Berilmasa, gift izohsiz yuboriladi

So'rov manzili shunchaki quyidagicha ko'rinadi — buni brauzerda ham sinab ko'rishingiz mumkin:

https://starsuno.uz/gift/buy?key=SIZNING_HASH_KALITINGIZ&gift_id=5170145012310081615&username=monk&text=Tabriklayman!

Muvaffaqiyatli javob

{
  "ok": true,
  "message": "Gift muvaffaqiyatli yuborildi!",
  "balance": 138000
}

Xato javob

{
  "ok": false,
  "code": "009",
  "error": "Gift id raqami topilmadi"
}

Xatoliklar

Kod	Izoh
`001`	Hash Key parametri mavjud emas
`002`	Hash Key topilmadi yoki xato
`003`	Hisobda mablag' yetarli emas
`004`	Stars yuborishda xatolik
`005`	Premium yuborishda xatolik
`006`	Username topilmadi
`007`	Premium `month` o'zgaruvchisi 3, 6 yoki 12 bo'lishi shart
`008`	Stars miqdori 50 - 10000 oralig'ida bo'lishi kerak
`009`	Gift id raqami topilmadi
`010`	Izoh juda ham uzun
`011`	Gift yuborishda xatolik

API kalitini olishga tayyormisiz?

Botdagi Dasturchi paneli orqali bir necha soniyada test kalitini oling.

Botni ochish