HyperPin REST API v1

O'z loyihangizga Telegram Stars va Premium xaridlarini avtomatlashtirilgan tarzda ulab oling. Barcha so'rovlar JSON formatida amalga oshiriladi.

Base URL

Barcha API so'rovlari quyidagi manzilga yuborilishi kerak:

https://api.hyperpin.top/api/v1

Autentifikatsiya

Xavfsizlikni ta'minlash uchun har bir so'rov X-API-Key sarlavhasi (header) orqali yuborilishi shart. API kalitini bot admin panelidan olishingiz mumkin.

Headers

X-API-Key: hp_live_your_secret_api_key
Content-Type: application/json

Mening Hisobim

API kalit egasining joriy balansi va holatini tekshirish.

GET /me

Response (200 OK)

{
  "status": "success",
  "data": {
    "user_id": 123456789,
    "balance": 150000
  }
}

Narxlar

Joriy Stars va Premium obuna narxlarini olish.

GET /prices

Telegram Stars Xarid Qilish

Foydalanuvchiga kerakli miqdorda Telegram yulduzchalarini yuborish.

POST /buy/stars

Parametr	Turi	Ta'rif
recipient	string	Qabul qiluvchining username'i (ms: "durov")
quantity	integer	Yulduzchalar miqdori (Minimal: 50)

Request Body

{
  "recipient": "durov",
  "quantity": 100
}

Premium Obuna Xarid Qilish

Foydalanuvchiga Telegram Premium sovg'a qilish.

POST /buy/premium

Parametr	Turi	Ta'rif
recipient	string	Qabul qiluvchining username'i (ms: "durov")
months	integer	Obuna muddati. Faqat: 3, 6 yoki 12

Request Body

{
  "recipient": "durov",
  "months": 3
}

Buyurtma Holati

Bajarilgan xaridning joriy holatini tekshirish.

GET /order/{tx_id}

Response (200 OK)

{
  "status": "success",
  "data": {
    "id": 45,
    "service": "stars",
    "amount": 100,
    "target": "durov",
    "status": "completed"
  }
}