API Dokumentatsiya

Telegram Stars va Premium sotib olish uchun oddiy REST API. Kassangizga wallet ulang — keyin faqat bitta so'rov yuboring.

Base URL https://socapi.uz

Auth X-API-Key

Format JSON / Query

Response success · error_code

Tezkor boshlash

Kassa yarating

Panelda yangi kassa yarating va TON wallet seed ni ulang

API kalit oling

Kassaning API kalitini X-API-Key headerga qo'shing

So'rov yuboring

username va amount bilan POST yuboring — tayyor

Sotib olish

Stars va Premium sotib olish endpointlari

POST /stars/buy

Telegram Stars sotib olish

URL

https://socapi.uz/stars/buy

cURL

curl -X POST 'https://socapi.uz/stars/buy' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"username": "durov", "amount": 100}'

Request body JSON

Maydon	Tur	Holat	Tavsif
X-API-Key	header	Majburiy	Kassaning API kaliti
username	string	Majburiy	Telegram username
amount	integer	Majburiy	Min: 50, max: 100,000
currency	string	Ixtiyoriy	ton yoki usdt

Request JSON body

{
  "username": "durov",
  "amount": 100
}

Response 200 OK

{
  "success": true,
  "data": {
    "transaction_id": "78f6a...",
    "username": "durov",
    "amount": 100
  }
}

Xato javoblari

MISSING_USERNAME400

{
  "success": false,
  "error_code": "MISSING_USERNAME"
}

AMOUNT_TOO_LOW400

{
  "success": false,
  "error_code": "AMOUNT_TOO_LOW"
}

AMOUNT_TOO_HIGH400

{
  "success": false,
  "error_code": "AMOUNT_TOO_HIGH"
}

INVALID_CURRENCY400

{
  "success": false,
  "error_code": "INVALID_CURRENCY"
}

MISSING_SEED400

{
  "success": false,
  "error_code": "MISSING_SEED"
}

INVALID_API_KEY401

{
  "success": false,
  "error_code": "INVALID_API_KEY"
}

RATE_LIMITED429

{
  "success": false,
  "error_code": "RATE_LIMITED"
}

INTERNAL_ERROR500

{
  "success": false,
  "error_code": "INTERNAL_ERROR"
}

POST /premium/buy

Telegram Premium sotib olish

URL

https://socapi.uz/premium/buy

cURL

curl -X POST 'https://socapi.uz/premium/buy' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"username": "durov", "months": 3}'

Xato javoblari

MISSING_USERNAME400

{
  "success": false,
  "error_code": "MISSING_USERNAME"
}

INVALID_MONTHS400

{
  "success": false,
  "error_code": "INVALID_MONTHS"
}

MISSING_SEED400

{
  "success": false,
  "error_code": "MISSING_SEED"
}

ALREADY_PREMIUM200

{
  "success": false,
  "error": "Foydalanuvchida allaqachon Telegram Premium bor",
  "error_code": "ALREADY_PREMIUM"
}

USER_NOT_FOUND200

{
  "success": false,
  "error": "Foydalanuvchi topilmadi",
  "error_code": "USER_NOT_FOUND"
}

FRAGMENT_ERROR200

{
  "success": false,
  "error": "Fragment: xato matni",
  "error_code": "FRAGMENT_ERROR"
}

INVALID_API_KEY401

{
  "success": false,
  "error_code": "INVALID_API_KEY"
}

RATE_LIMITED429

{
  "success": false,
  "error_code": "RATE_LIMITED"
}

INTERNAL_ERROR500

{
  "success": false,
  "error_code": "INTERNAL_ERROR"
}

Qidirish

Telegram username tekshirish

GET /searchUser

Username qidirish va Premium tekshirish

URL

https://socapi.uz/searchUser

cURL

curl 'https://socapi.uz/searchUser?username=durov'

Query parametrlar Query

Parametr	Tur	Holat	Tavsif
username	string	Majburiy	Telegram username

Topildi 200

{
  "success": true,
  "username": "durov",
  "is_premium": false,
  "name": "Pavel Durov"
}

Premium bor 200

{
  "success": true,
  "username": "durov",
  "is_premium": true,
  "name": null
}

USER_NOT_FOUND 400

{
  "success": false,
  "error_code": "USER_NOT_FOUND"
}