API Hujjatlari | Yuksal Sim Shop

GET Balans tekshirish

▼

📝 Tavsif: Foydalanuvchi balansini tekshirish.

https://www.s94.surkhandc1.uz/api?action=getBalance&key={API_KALIT}

Parametr	Turi	Majburiylik	Tavsif
`action`	string	✅ Talab qilinadi	`getBalance`
`key`	string	✅ Talab qilinadi	Sizning API kalitingiz

📥 Javob:
{
  "success": true,
  "balance": 125000,
  "user_id": 5337551034,
  "discount": 0,
  "spent": 50000,
  "payment": 175000
}

GET Davlatlar ro'yxati

▼

📝 Tavsif: Mavjud davlatlar va ularning narxlarini olish.

https://www.s94.surkhandc1.uz/api?action=getCountries&key={API_KALIT}

Parametr	Turi	Majburiylik	Tavsif
`action`	string	✅ Talab qilinadi	`getCountries`
`key`	string	✅ Talab qilinadi	Sizning API kalitingiz

📥 Javob:
{
  "success": true,
  "countries": [
    {"code": "UZ", "name": "Uzbekistan", "price": 2500, "qty": 5},
    {"code": "RU", "name": "Russia", "price": 3000, "qty": 3}
  ]
}

GET Raqam sotib olish

▼

📝 Tavsif: Telegram ro'yxatdan o'tish uchun virtual raqam sotib olish.

https://www.s94.surkhandc1.uz/api?action=getNumber&key={API_KALIT}&country=UZ

Parametr	Turi	Majburiylik	Tavsif
`action`	string	✅ Talab qilinadi	`getNumber`
`key`	string	✅ Talab qilinadi	Sizning API kalitingiz
`country`	string	✅ Talab qilinadi	Davlat kodi (UZ, RU, KZ, US, GB, DE, FR, TR, IN, CN, JP)

📥 Javob:
{
  "success": true,
  "phone": "+998901234567",
  "order_id": "API_67890abc",
  "number_id": 123,
  "price": 2500,
  "country": "UZ"
}

ℹ️ Eslatma: Raqamni faqat norasmiy Telegram ilovalarida (Telegraph, Plus Messenger va boshqalar) ishlating! Rasmiy ilovada ban bo'lish xavfi bor.

GET SMS kodni olish

▼

📝 Tavsif: Sotib olingan raqamga kelgan SMS kodni olish.

https://www.s94.surkhandc1.uz/api?action=getCode&key={API_KALIT}&order_id={ORDER_ID}

Parametr	Turi	Majburiylik	Tavsif
`action`	string	✅ Talab qilinadi	`getCode`
`key`	string	✅ Talab qilinadi	Sizning API kalitingiz
`order_id`	string	✅ Talab qilinadi	getNumber dan olingan order_id

📥 Javob:
{
  "success": true,
  "code": "123456",
  "password": ""
}

⚠️ Diqqat! Kod kelishi uchun 30-60 soniya kutish kerak. Agar kod kelmasa, qayta so'rov yuboring.

GET Stars sotib olish

▼

📝 Tavsif: Telegram Stars sotib olish.

https://www.s94.surkhandc1.uz/api?action=buyStars&key={API_KALIT}&username={USERNAME}&amount=100

Parametr	Turi	Majburiylik	Tavsif
`action`	string	✅ Talab qilinadi	`buyStars`
`key`	string	✅ Talab qilinadi	Sizning API kalitingiz
`username`	string	✅ Talab qilinadi	Qabul qiluvchi username (@ belgisiz)
`amount`	integer	✅ Talab qilinadi	Stars miqdori (minimal 50)

📥 Javob:
{
  "success": true,
  "order_id": "S20241215123456",
  "amount": 100,
  "username": "Yuksal_Boss",
  "price": 35000
}

GET Premium sotib olish

▼

📝 Tavsif: Telegram Premium sotib olish.

https://www.s94.surkhandc1.uz/api?action=buyPremium&key={API_KALIT}&username={USERNAME}&months=1

Parametr	Turi	Majburiylik	Tavsif
`action`	string	✅ Talab qilinadi	`buyPremium`
`key`	string	✅ Talab qilinadi	Sizning API kalitingiz
`username`	string	✅ Talab qilinadi	Qabul qiluvchi username (@ belgisiz)
`months`	integer	✅ Talab qilinadi	Oylar soni (1-12)

📥 Javob:
{
  "success": true,
  "order_id": "P20241215123456",
  "months": 1,
  "username": "Yuksal_Boss",
  "price": 25000
}

GET Foydalanuvchi ma'lumotlari

▼

📝 Tavsif: Foydalanuvchi haqida to'liq ma'lumot olish.

https://www.s94.surkhandc1.uz/api?action=getUserInfo&key={API_KALIT}

Parametr	Turi	Majburiylik	Tavsif
`action`	string	✅ Talab qilinadi	`getUserInfo`
`key`	string	✅ Talab qilinadi	Sizning API kalitingiz

📥 Javob:
{
  "success": true,
  "user_id": 5337551034,
  "first_name": "Yuksal",
  "last_name": "Boss",
  "username": "Yuksal_Boss",
  "balance": 125000,
  "spent": 50000,
  "payment": 175000,
  "discount": 0,
  "referal": 5
}

GET Buyurtma holati

▼

📝 Tavsif: Buyurtma holatini tekshirish.

https://www.s94.surkhandc1.uz/api?action=getOrderStatus&key={API_KALIT}&order_id={ORDER_ID}

Parametr	Turi	Majburiylik	Tavsif
`action`	string	✅ Talab qilinadi	`getOrderStatus`
`key`	string	✅ Talab qilinadi	Sizning API kalitingiz
`order_id`	string	✅ Talab qilinadi	Buyurtma ID (getNumber, buyStars yoki buyPremium dan olingan)

📥 Javob (raqam):
{
  "success": true,
  "type": "number",
  "status": "waiting",
  "phone": "+998901234567",
  "code": null,
  "price": 2500
}

GET API kalit yangilash

▼

📝 Tavsif: Yangi API kalit yaratish (eski kalit o'chiriladi).

https://www.s94.surkhandc1.uz/api?action=newKey&key={API_KALIT}

Parametr	Turi	Majburiylik	Tavsif
`action`	string	✅ Talab qilinadi	`newKey`
`key`	string	✅ Talab qilinadi	Hozirgi API kalitingiz

📥 Javob:
{
"success": true,
"new_api_key": "abc123def456ghi"
}

⚠️ Diqqat! Eski API kalit o'chiriladi va endi ishlamaydi! Yangi kalitni saqlab oling.

📝 Kod misollari

▼

PHP da ishlatish:

<?php
$api_key = "SIZNING_API_KALITINGIZ";
$action = "getBalance";

$url = "https://www.s94.surkhandc1.uz/api?action={$action}&key={$api_key}";

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_TIMEOUT => 30
]);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

if ($data['success']) {
    echo "✅ Balans: " . number_format($data['balance']) . " so'm";
} else {
    echo "❌ Xatolik: " . $data['error'];
}
?>

Python da ishlatish:

import requests

api_key = "SIZNING_API_KALITINGIZ"
url = f"https://www.s94.surkhandc1.uz/api?action=getBalance&key={api_key}"

response = requests.get(url)
data = response.json()

if data['success']:
    print(f"✅ Balans: {data['balance']} so'm")
else:
    print(f"❌ Xatolik: {data['error']}")

cURL (Terminal) da ishlatish:

curl -X GET "https://www.s94.surkhandc1.uz/api?action=getBalance&key=SIZNING_API_KALITINGIZ"

⭐ Yuksal Sim Shop API