📞 Support

Telegram Stars & Premium API

Tez, ishonchli va sodda API Telegram Stars va Premium obunalar uchun

Boshlash

Nega UPGROW?

⚡

Chaqmoq tez

Telegram Stars sotib olishni soniyalarda qayta ishlang

🔒

Xavfsiz va ishonchli

API kalit autentifikatsiyasi va shifrlangan tranzaksiyalar

💎

Premium qo'llab-quvvatlash

Telegram Premium obunalarini (3, 6, 12 oy) xarid qiling

📊

Real vaqt holati

Buyurtmalaringizni webhook va admin panel bilan kuzating

🌐

RESTful API

Oddiy va yaxshi hujjatlashtirilgan REST API

🚀

Yuqori ishlash

Minglab so'rovlarni FastAPI va PostgreSQL bilan ishlating

API Hujjatlari

🌐 Asosiy URL

Production: https://telegram.upgrow.uz
Lokal: http://localhost:8010

🔑 Autentifikatsiya

Barcha API so'rovlari API kalitini talab qiladi. Uni so'rov sarlavhasiga qo'shing:

X-API-Key: your_api_key_here

GET API holatini tekshirish

/v1/status/

API kalitingizni tekshiring va API ishlaydimi tekshiring.

Sarlavhalar

Sarlavha Turi Majburiy Tavsif
X-API-Key string Majburiy Sizning API kalitingiz

So'rov misoli

curl -X GET "http://localhost:8010/v1/status/" \
  -H "X-API-Key: your_api_key_here"

Javob misoli

{
  "success": true,
  "message": "API is operational",
  "api_key_info": {
    "name": "My API Key",
    "prefix": "sk_abc",
    "is_active": true,
    "usage_count": 42
  }
}

POST Telegram Username Tekshirish

/v1/check-username/

Telegram username'ni mavjudligini va to'g'riligini tekshiring. Bu endpoint Telethon userbot orqali username'ning formatini va Telegram'da mavjudligini tekshiradi.

So'rov tanasi

Parametr Turi Majburiy Tavsif
username string Majburiy Tekshiriladigan Telegram username (@ bilan yoki bo'lmasdan)

So'rov misoli

curl -X POST "https://telegram.upgrow.uz/v1/check-username/" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "dilmurodbek_e"
  }'

Javob misoli

✓ Username band (200 OK)
{
  "success": true,
  "valid": true,
  "available": false,
  "username": "dilmurodbek_e",
  "message": "Username is already taken",
  "user_info": {
    "id": 123456789,
    "first_name": "Dilmurod",
    "last_name": "Ergashev",
    "username": "dilmurodbek_e",
    "is_bot": false,
    "is_verified": false,
    "is_scam": false,
    "is_fake": false
  }
}
✓ Username bo'sh (200 OK)
{
  "success": true,
  "valid": true,
  "available": true,
  "username": "some_available_username",
  "message": "Username is available"
}
✗ Noto'g'ri format (200 OK)
{
  "success": false,
  "valid": false,
  "available": false,
  "username": "abc",
  "message": "Username must be at least 5 characters long"
}
✗ Rate limit (429 Too Many Requests)
{
  "success": false,
  "valid": null,
  "available": null,
  "username": "someuser",
  "message": "Rate limited. Please try again in 60 seconds",
  "retry_after": 60
}

Javob maydonlari

Maydon Turi Tavsif
success boolean Tekshirish muvaffaqiyatli bo'lsa true
valid boolean/null Username formati to'g'ri bo'lsa true
available boolean/null Username band bo'lmasa true
username string Tekshirilgan username
message string Natija haqida tavsif
user_info object/null Username band bo'lsa, foydalanuvchi ma'lumotlari

Validatsiya qoidalari

  • Username kamida 5 ta belgidan iborat bo'lishi kerak
  • Username maksimal 32 ta belgidan iborat bo'lishi kerak
  • Faqat harflar, raqamlar va pastki chiziq (_) ruxsat etilgan
  • Username bo'sh bo'lmasligi kerak

POST Telegram Stars sotib olish

/v1/buy-order/

Muayyan foydalanuvchi uchun Telegram Stars xarid qiling.

So'rov tanasi

Parametr Turi Majburiy Tavsif
username string Majburiy Telegram username (@ bilan yoki bo'lmasdan)
quantity integer Majburiy Yulduzlar soni (50 - 10,000,000)
type string Majburiy "stars"
seed string Majburiy TON hamyon seed phrase
callback_url string Ixtiyoriy Buyurtma holati uchun webhook URL

So'rov misoli

curl -X POST "http://localhost:8010/v1/buy-order/" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "@johndoe",
    "quantity": 1000,
    "type": "stars",
    "seed": "word1 word2 word3...",
    "callback_url": "https://your-site.com/webhook"
  }'

POST Telegram Premium sotib olish

/v1/buy-order/

Foydalanuvchi uchun Telegram Premium obunasini xarid qiling.

⚠️ Muhim:

Premium xaridlar uchun callback_url majburiy! Buyurtma holatini kuzatish uchun webhook URL ni ko'rsating.

So'rov tanasi

Parametr Turi Majburiy Tavsif
username string Majburiy Telegram username (@ bilan yoki bo'lmasdan)
quantity integer Majburiy Davomiyligi oylar (3, 6, yoki 12)
type string Majburiy "premium"
seed string Majburiy TON hamyon seed phrase
callback_url string Majburiy Buyurtma holati uchun webhook URL (Premium uchun majburiy!)

So'rov misoli

curl -X POST "https://telegram.upgrow.uz/v1/buy-order/" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "@johndoe",
    "quantity": 6,
    "type": "premium",
    "seed": "word1 word2 word3...",
    "callback_url": "https://your-site.com/webhook"
  }'

Javob misoli

✓ Muvaffaqiyatli yaratildi (200 OK)
{
  "success": true,
  "message": "Order created",
  "order_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "pending"
}
✗ Callback URL yo'q (400 Bad Request)
{
  "success": false,
  "message": "callback_url is required for premium purchases"
}

🔔 Webhook Callbacks

Agar siz callback_url parametrini bersangiz, buyurtma holati o'zgarganda sizning endpointingizga POST so'rov yuboramiz:

Callback ma'lumotlari

{
  "order_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "success",
  "username": "johndoe",
  "quantity": 1000,
  "order_type": "stars",
  "ledger_id": "tx_hash_here",
  "amount": 5.25,
  "error_message": null,
  "created_at": "2026-01-15T10:30:00Z",
  "completed_at": "2026-01-15T10:30:45Z"
}

Holat qiymatlari

  • pending - Buyurtma qayta ishlanmoqda
  • success - Buyurtma muvaffaqiyatli bajarildi
  • cancelled - Buyurtma bekor qilindi yoki xatolik yuz berdi

❌ Xato javoblari

Xatolik yuz berganda, API JSON javob bilan xato ma'lumotlarini qaytaradi:

401 Unauthorized

{
  "detail": "Invalid API key"
}

400 Bad Request

{
  "success": false,
  "message": "Stars quantity must be between 50 and 10,000,000"
}

422 Validation Error

{
  "detail": [
    {
      "loc": ["body", "username"],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}