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'shing2
So'rov yuboring
Kerakli parametrlar va JSON body bilan POST yuboring
3
Natijani tekshiring
success yoki error_code ga qarangXato 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
| Parametr | Tur | Holat | Tavsif |
|---|---|---|---|
| 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"
}
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
| Parametr | Tur | Holat | Tavsif |
|---|---|---|---|
| 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"
}