SOC API — API Dokumentatsiya

API Dokumentatsiya

Telegram Stars, Premium, Gift va raqam qidirish uchun to'liq API. Har bir so'rovda X-Api-Key headeri talab qilinadi.

Base URL

https://soc-api.uz

Autentifikatsiya

X-Api-Key (header)

So'rov formati

POST (body shart emas)

Javob formati

success / error / error_code

API kalit oling

Paneldan API kalitingizni oling va X-Api-Key headeriga qo'shing

So'rov yuboring

Kerakli parametrlar va JSON body bilan POST yuboring

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	X-Api-Key headeri yuborilmagan yoki bo'sh	Barcha
INVALID_API_KEY	401	X-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
INVALID_USERNAME	400	Username format xato (4–32 harf, raqam yoki _)	/buyStars, /buyPremium
WALLET_NOT_CONNECTED	403	Hamyon ulanmagan — Dashboard > Hamyon bo'limidan TON seed kiriting	/buyStars, /buyPremium
INSUFFICIENT_FUNDS	400	Hamyonda yetarli TON/USDT balans yo'q	/buyStars, /buyPremium
WALLET_BUSY	503	Hamyon boshqa operatsiyada band — 5 soniyadan so'ng qayta urinib ko'ring	/buyStars, /buyPremium
FRAGMENT_TIMEOUT	503	Fragment yoki TonCenter serveriga ulanish vaqti tugadi	/buyStars, /buyPremium
WALLET_DECRYPT_ERROR	500	Hamyon ma'lumotlarini o'qib bo'lmadi — qayta seed kiriting	/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://soc-api.uz/buyStars?username=durov&amount=100

cURL tez sinov uchun

Shell

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

Python

import requests

res = requests.post(
    'https://soc-api.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 (@ belgisisiz ham qabul qilinadi, 4–32 belgi)
amount	integer	Majburiy	Stars miqdori — min: 50, max: 1,000,000

Javoblar

200 OK 400 Xato 401/403 429 Limit 500/503

JSON — 200 OK

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

JSON — 400 (miqdor xatosi)

{
  "success": false,
  "error": "Minimum stars miqdori 50 ta",
  "error_code": "AMOUNT_TOO_LOW"
}

JSON — 400 (balans yetarli emas)

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

JSON — 401 (API kalit xatosi)

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

JSON — 403 (hamyon ulanmagan)

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

JSON — 429 (limit)

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

JSON — 503 (hamyon band)

{
  "success": false,
  "error": "Hamyon band. 5 soniyadan so'ng urinib ko'ring.",
  "error_code": "WALLET_BUSY"
}

POST /buyPremium Telegram Premium sotib olish ▾

URL https://soc-api.uz/buyPremium?username=durov&months=3

cURL tez sinov uchun

Shell

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

Python

import requests

res = requests.post(
    'https://soc-api.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 (@ belgisisiz ham qabul qilinadi, 4–32 belgi)
months	integer	Majburiy	Obuna muddati: faqat 3, 6 yoki 12

Javoblar

200 OK 400 Xato 401/403 429 Limit 500/503

JSON — 200 OK

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

JSON — 400 (muddat xatosi)

{
  "success": false,
  "error": "months faqat 3, 6 yoki 12 bolishi mumkin",
  "error_code": "INVALID_MONTHS"
}

JSON — 400 (balans yetarli emas)

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

JSON — 403 (hamyon ulanmagan)

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

JSON — 429 (limit)

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

Qidirish

Telegram username tekshirish

GET /searchUser Username qidirish va Premium tekshirish ▾

URL https://soc-api.uz/searchUser?username=durov

cURL tez sinov uchun

Shell

curl 'https://soc-api.uz/searchUser?username=Orifjonovii' \
     -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 (@ belgisisiz ham qabul qilinadi)

Javoblar

200 OK 400 Xato 401 Auth

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"
}