API Dokumentatsiya

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

Base URLhttps://socapi.uz

AuthX-API-Key

FormatJSON / Query

Responsesuccess · error_code

Tezkor boshlash

Kassa yarating

Panelda yangi kassa yarating va Gram 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

Hech narsa topilmadi

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

RequestJSON body

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

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

To'ldirish

Fragment TON balansini to'ldirish

POST /ton/topup

Fragment TON balansini to'ldirish

URL

https://socapi.uz/ton/topup

cURL

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

Request body JSON

Maydon	Tur	Holat	Tavsif
X-API-Key	header	Majburiy	Kassaning API kaliti
username	string	Majburiy	Telegram username
amount	integer	Majburiy	TON miqdori — min: 1, max: 10,000

RequestJSON body

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

Response200 OK

{
  "success": true,
  "data": {
    "transaction_id": "a1b2c...",
    "username": "durov",
    "amount": 5
  }
}

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

MISSING_SEED400

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

CASHIER_INACTIVE403

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

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

POST /searchUser

Username qidirish va Premium tekshirish

URL

https://socapi.uz/searchUser

cURL

curl -X POST 'https://socapi.uz/searchUser?username=durov&api_key=YOUR_API_KEY'

Query parametrlar Query

Parametr	Tur	Holat	Tavsif
username	string	Majburiy	Telegram username — @ belgisisiz ham qabul qilinadi
api_key	string	Majburiy	Kassaning API kaliti

Topildi200

{
  "ok": true,
  "message": "Telegram foydalanuvchi topildi.",
  "result": {
    "username": "durov",
    "name": "Pavel Durov",
    "photo": "https://...",
    "is_premium": false
  }
}

Premium bor200

{
  "ok": true,
  "message": "Telegram foydalanuvchi topildi.",
  "result": {
    "username": "durov",
    "name": "Pavel Durov",
    "photo": "https://...",
    "is_premium": true
  }
}

USER_NOT_FOUND404

{
  "ok": false,
  "message": "@durov topilmadi yoki Telegram'da ro'yxatdan o'tmagan"
}

Xato javoblari

MISSING_API_KEY401

{
  "ok": false,
  "message": "API kalit kiritilmagan"
}

INVALID_API_KEY401

{
  "ok": false,
  "message": "API kalit noto'g'ri yoki mavjud emas"
}

MISSING_USERNAME400

{
  "ok": false,
  "message": "username kiritilmagan"
}

USER_NOT_FOUND404

{
  "ok": false,
  "message": "@durov topilmadi yoki Telegram'da ro'yxatdan o'tmagan"
}