ELDER API — Dokumentatsiya

API Dokumentatsiya

Stars va Premium sotib olish + username qidirish API'si. Har bir so'rovda X-Api-Key header talab qilinadi.

Base URL

https://elder.uz

Autentifikatsiya

X-Api-Key (header)

So'rov formati

Query parametrlar

Javob formati

success / error / error_code

Parallel yuborilgan buyurtmalar avtomatik navbatga tushib, ketma-ket (~1s farq bilan) bajariladi — xatolik bermaydi, faqat javob biroz kechikishi mumkin.

API kalit oling

Panel > Dashboard'dan API kalitni oling

So'rov yuboring

Query parametrlar bilan so'rov jo'nating

Natijani tekshiring

success yoki error_code ga qarang

Xato kodlari

Barcha endpointlarda qaytariladigan xato kodlari

To'liq jadval

Xato javob namunasi

{
  "success": false,
  "error": "API kalit noto'g'ri yoki mavjud emas",
  "error_code": "INVALID_API_KEY"
}

error_code	HTTP	Tavsif	Qayerda
MISSING_API_KEY	401	X-Api-Key header yuborilmagan	Barcha
INVALID_API_KEY	401	API kalit noto'g'ri	Barcha
MISSING_USERNAME	400	username bo'sh	Barcha
INVALID_USERNAME	400	Format xato — 4–32 harf/raqam/_	Barcha
AMOUNT_TOO_LOW	400	Minimum 50 stars	/buyStars
AMOUNT_TOO_HIGH	400	Maksimum 1,000,000 stars	/buyStars
INVALID_MONTHS	400	Faqat 3, 6 yoki 12	/buyPremium
USER_NOT_FOUND	400	Username Telegram'da topilmadi	Barcha
WALLET_NOT_CONNECTED	403	TON hamyon ulanmagan (Panel > Hamyon)	/buyStars, /buyPremium
INSUFFICIENT_FUNDS	400	Hamyonda yetarli TON/USDT yo'q	/buyStars, /buyPremium
ORDER_IN_PROGRESS	429	Xuddi shu buyurtma allaqachon bajarilmoqda	/buyStars, /buyPremium
FRAGMENT_QUEUE_TIMEOUT	503	Global navbat band — qayta urinib ko'ring	Barcha
WALLET_BUSY	503	Hamyon boshqa operatsiyada band	/buyStars, /buyPremium
FRAGMENT_TIMEOUT	503	Fragment/TonCenter serveri javob bermadi	/buyStars, /buyPremium
FRAGMENT_RATELIMIT	503	Fragment tomonidan rate-limit	Barcha
FRAGMENT_AUTH_ERROR	503	Fragment sessiyasi xatosi	Barcha
FRAGMENT_ERROR	400	Fragment'dan umumiy xato javobi	Barcha
WALLET_DECRYPT_ERROR	500	Hamyon ma'lumoti o'qilmadi — qayta ulang	/buyStars, /buyPremium
RATE_LIMITED	429	Bir daqiqada so'rovlar soni limitdan oshdi (IP bo'yicha)	Barcha
IP_BLOCKED	429	IP suiiste'mol tufayli vaqtincha bloklangan	Barcha
INTERNAL_ERROR	500	Kutilmagan server xatosi	Barcha

Sotib olish

Stars va Premium sotib olish endpointlari

POST /buyStars Telegram Stars sotib olish

URL https://elder.uz/buyStars?username=durov&amount=100

cURL tez sinov

Shell

curl -X POST 'https://elder.uz/buyStars?username=durov&amount=100' \
     -H 'X-Api-Key: YOUR_KEY'

Python

import requests

res = requests.post(
    'https://elder.uz/buyStars',
    headers={'X-Api-Key': 'YOUR_KEY'},
    params={'username': 'durov', 'amount': 100},
)
print(res.json())

Header

Header	Tur	Holat	Tavsif
X-Api-Key	string	Majburiy	Paneldan olingan API kalit

Query parametrlar

Parametr	Tur	Holat	Tavsif
username	string	Majburiy	Telegram username (@ bilan yoki bo'lmasa ham, 4–32 belgi)
amount	integer	Majburiy	Stars miqdori — min 50, max 1,000,000

Javoblar

200 OK 400 401/403 429 500/503

200 OK

{
  "success": true,
  "data": {
    "transaction_id": "78f6a4572ac1bde6...",
    "username": "durov",
    "amount": 100,
    "cost": 0.3476,
    "total": 0.354552,
    "currency": "ton"
  }
}

400 — balans yetarli emas

{
  "success": false,
  "error": "Hamyonda yetarli TON yo'q",
  "error_code": "INSUFFICIENT_FUNDS"
}

403 — hamyon ulanmagan

{
  "success": false,
  "error": "Hamyon ulanmagan. Panel > Hamyon bo'limidan seed kiriting.",
  "error_code": "WALLET_NOT_CONNECTED"
}

503 — navbat band

{
  "success": false,
  "error": "Serverda navbat band. Birozdan song qayta urinib koring.",
  "error_code": "FRAGMENT_QUEUE_TIMEOUT"
}

POST /buyPremium Telegram Premium sotib olish

URL https://elder.uz/buyPremium?username=durov&months=3

cURL tez sinov

Shell

curl -X POST 'https://elder.uz/buyPremium?username=durov&months=3' \
     -H 'X-Api-Key: YOUR_KEY'

Python

import requests

res = requests.post(
    'https://elder.uz/buyPremium',
    headers={'X-Api-Key': 'YOUR_KEY'},
    params={'username': 'durov', 'months': 3},
)
print(res.json())

Header

Header	Tur	Holat	Tavsif
X-Api-Key	string	Majburiy	Paneldan olingan API kalit

Query parametrlar

Parametr	Tur	Holat	Tavsif
username	string	Majburiy	Telegram username (@ bilan yoki bo'lmasa ham, 4–32 belgi)
months	integer	Majburiy	Muddat — faqat 3, 6 yoki 12

Javoblar

200 OK 400 401/403 429 500/503

200 OK

{
  "success": true,
  "data": {
    "transaction_id": "abc123def456...",
    "username": "durov",
    "months": 3,
    "cost": 1.25,
    "total": 1.275,
    "currency": "ton",
    "price_display": "≈ 1.25 TON"
  }
}

429 — takroriy buyurtma

{
  "success": false,
  "error": "Ushbu buyurtma allaqachon bajarilayapti.",
  "error_code": "ORDER_IN_PROGRESS"
}

Qidirish

Username mavjudligini tekshirish

GET /searchUser Username qidirish

URL https://elder.uz/searchUser?username=durov

cURL tez sinov

Shell

curl 'https://elder.uz/searchUser?username=durov' \
     -H 'X-Api-Key: YOUR_KEY'

Header

Header	Tur	Holat	Tavsif
X-Api-Key	string	Majburiy	Paneldan olingan API kalit

Query parametrlar

Parametr	Tur	Holat	Tavsif
username	string	Majburiy	Telegram username (@ bilan yoki bo'lmasa ham, 4–32 belgi)

Javoblar

200 OK 400 401 500/503

200 OK

{
  "success": true,
  "username": "durov",
  "name": "Pavel Durov",
  "is_premium": false,
  "photo_url": "https://cdn4.telesco.pe/file/...",
  "recipient": "C8jFehEDcrbnRJ3PkMj..."
}

400 — topilmadi

{
  "success": false,
  "error": "@durov topilmadi",
  "error_code": "USER_NOT_FOUND"
}

Hisoblash

Hamyon balansi nechta Starsga yetishini hisoblash

GET /stars/value Balans nechta Starsga yetishini hisoblash

URL https://elder.uz/stars/value

cURL tez sinov

Shell

curl 'https://elder.uz/stars/value' \
     -H 'X-Api-Key: YOUR_KEY'

Header

Header	Tur	Holat	Tavsif
X-Api-Key	string	Majburiy	Paneldan olingan API kalit

Izoh

API kalit egasining ulangan hamyon balansi joriy holatda nechta Stars sotib olishga yetishini qaytaradi. Hisoblash hamyonning to'lov usuliga qarab ikki xil yo'l bilan amalga oshiriladi: agar to'lov usuli USDT bo'lsa — barqaror 0.015 USDT/star kursi bilan to'g'ridan-to'g'ri; agar TON bo'lsa — avval joriy TON/USD bozor narxi olinadi, TON balansi USD ga o'giriladi, so'ng xuddi shu 0.015 USDT/star kursi bilan Stars soni hisoblanadi.

Javoblar

200 OK (USDT) 200 OK (TON) 403 401 500/503

200 OK — to'lov usuli USDT

{
  "success": true,
  "data": {
    "currency": "usdt",
    "balance": 34.49,
    "usdt_per_star": 0.015,
    "stars_available": 2299
  }
}

200 OK — to'lov usuli TON

{
  "success": true,
  "data": {
    "currency": "ton",
    "balance": 12.34,
    "ton_usd_price": 1.63,
    "usd_value": 20.11,
    "usdt_per_star": 0.015,
    "stars_available": 1340
  }
}

403 — hamyon ulanmagan

{
  "success": false,
  "error": "Hamyon ulanmagan. Dashboard > Hamyon bo'limidan seed kiriting.",
  "error_code": "WALLET_NOT_CONNECTED"
}

503 — TON narxi olinmadi

{
  "success": false,
  "error": "TON narxini olib bo'lmadi, birozdan so'ng qayta urinib ko'ring",
  "error_code": "TON_PRICE_UNAVAILABLE"
}