Bosh sahifa Docs Panel
API Dokumentatsiya
Telegram Stars, Premium, Gift va raqam qidirish uchun to'liq API. Har bir so'rovda api_key parametri talab qilinadi.
Base URL
https://elder.uz
Autentifikatsiya
api_key (query param)
So'rov formati
POST (body shart emas)
Javob formati
success / error / error_code
1
API kalit oling
Paneldan api_key ni oling va har so'rovga qo'shing
2
So'rov yuboring
Kerakli parametrlar va JSON body bilan POST yuboring
3
Natijani tekshiring
success yoki error_code ga qarang
Xato kodlari
Barcha endpointlarda qaytariladigan standart xato kodlari
Umumiy xato kodlari jadvali

Har bir xato javobida error_code maydoni bo'ladi — bu kodni dasturiy tekshirishga ishlatish mumkin.

Xato javob namunasi
{
  "success": false,
  "error": "API kalit noto'g'ri yoki mavjud emas",
  "error_code": "INVALID_API_KEY"
}
error_code HTTP Tavsif Qaysi endpointda
MISSING_API_KEY 401 api_key parametri yuborilmagan yoki bo'sh Barcha
INVALID_API_KEY 401 api_key noto'g'ri yoki mavjud emas Barcha
MISSING_USERNAME 400 username bo'sh yoki yuborilmagan /buyStars, /buyPremium, /searchUser
AMOUNT_TOO_LOW 400 Stars miqdori minimum 50 ta bo'lishi kerak /buyStars
AMOUNT_TOO_HIGH 400 Stars miqdori maksimum 1,000,000 ta /buyStars
INVALID_MONTHS 400 months faqat 3, 6 yoki 12 bo'lishi mumkin /buyPremium
USER_NOT_FOUND 400 Username topilmadi yoki Telegram'da mavjud emas /searchUser
FRAGMENT_INVALID_RESPONSE 502 Fragment serveridan noto'g'ri javob keldi /searchUser
ORDER_IN_PROGRESS 429 Xuddi shu foydalanuvchi uchun buyurtma hozir bajarilmoqda — biroz kuting /buyStars, /buyPremium
RATE_LIMITED 429 Juda tez so'rov — oxirgi muvaffaqiyatli buyurtmadan 3 soniya o'tmagan /buyStars, /buyPremium
INTERNAL_ERROR 500 Serverda kutilmagan xatolik yuz berdi Barcha
Sotib olish
Stars, Premium va Gift sotib olish endpointlari
POST /buyStars Telegram Stars sotib olish
URL https://elder.uz/buyStars?api_key=...&username=durov&amount=100
cURL tez sinov uchun
Shell
curl -X POST 'https://elder.uz/buyStars?api_key=YOUR_KEY&username=durov&amount=100'
Python
import requests

res = requests.post('https://elder.uz/buyStars', params={
    'api_key': 'YOUR_KEY',
    'username': 'durov',
    'amount': 100,
})
print(res.json())
Query parametrlar
ParametrTurHolatTavsif
api_key string Majburiy Paneldan olingan API kalit
username string Majburiy Telegram username (@ belgisisiz ham qabul qilinadi)
amount integer Majburiy Stars miqdori — min: 50, max: 1,000,000
Javoblar
200 OK 400 Xato 401 Auth 429 Limit 500 Server
JSON — 200 OK
{
  "success": true,
  "data": {
    "transaction_id": "78f6a4572ac1bde605e2481a4c816120...",
    "username": "durov",
    "amount": 100,
    "cost": 0.3476,
    "total": 0.354552
  }
}
JSON — 400 (miqdor xatosi)
{
  "success": false,
  "error": "Minimum stars miqdori 50 ta",
  "error_code": "AMOUNT_TOO_LOW"
}
JSON — 401 (API kalit xatosi)
{
  "success": false,
  "error": "API kalit noto'g'ri yoki mavjud emas",
  "error_code": "INVALID_API_KEY"
}
JSON — 429 (limit)
{
  "success": false,
  "error": "Ushbu buyurtma allaqachon bajarilayapti. Biroz kuting.",
  "error_code": "ORDER_IN_PROGRESS"
}
JSON — 500 (server xatosi)
{
  "success": false,
  "error": "Serverda ichki xatolik yuz berdi",
  "error_code": "CRITICAL_SERVER_ERROR"
}
POST /buyPremium Telegram Premium sotib olish
URL https://elder.uz/buyPremium?api_key=...&username=durov&months=3
cURL tez sinov uchun
Shell
curl -X POST 'https://elder.uz/buyPremium?api_key=YOUR_KEY&username=durov&months=3'
Python
import requests

res = requests.post('https://elder.uz/buyPremium', params={
    'api_key': 'YOUR_KEY',
    'username': 'durov',
    'months': 3,
})
print(res.json())
Query parametrlar
ParametrTurHolatTavsif
api_key string Majburiy Paneldan olingan API kalit
username string Majburiy Telegram username (@ belgisisiz ham qabul qilinadi)
months integer Majburiy Obuna muddati: faqat 3, 6 yoki 12
Javoblar
200 OK 400 Xato 401 Auth 429 Limit 500 Server
JSON — 200 OK
{
  "success": true,
  "data": {
    "transaction_id": "abc123def456...",
    "username": "durov",
    "months": 3,
    "cost": 1.2500,
    "total": 1.2750
  }
}
JSON — 400 (muddati xatosi)
{
  "success": false,
  "error": "months faqat 3, 6 yoki 12 bo'lishi mumkin",
  "error_code": "INVALID_MONTHS"
}
JSON — 429 (limit)
{
  "success": false,
  "error": "Juda tez so'rov. 3 soniyadan so'ng qayta urinib ko'ring.",
  "error_code": "RATE_LIMITED"
}
Qidirish
Telegram username tekshirish
GET /searchUser Username qidirish va Premium tekshirish
URL https://elder.uz/searchUser?username=durov
cURL tez sinov uchun
Shell
curl 'https://elder.uz/searchUser?username=Orifjonovii'
Query parametrlar
ParametrTurHolatTavsif
username string Majburiy Telegram username (@ belgisisiz ham qabul qilinadi)
Javoblar
200 OK 400 Xato
JSON — 200 OK (topildi)
{
  "success": true,
  "username": "durov",
  "is_premium": false,
  "name": "Pavel Durov",
  "recipient": "..."
}
JSON — 200 OK (Premium bor)
{
  "success": true,
  "username": "durov",
  "is_premium": true,
  "name": null,
  "recipient": null
}
JSON — 400 (topilmadi)
{
  "success": false,
  "error": "@durov topilmadi yoki Telegram'da ro'yxatdan o'tmagan",
  "error_code": "USER_NOT_FOUND"
}