REST API · v1

SMS API
HujjatlarДокументацияDocumentation

Virtual nomerlar olish va SMS kodlarini qabul qilish uchun to'liq REST API. GET so'rovlari, JSON javoblar. Полный REST API для получения виртуальных номеров и приёма SMS кодов. GET запросы, JSON ответы. Full REST API for getting virtual numbers and receiving SMS codes. GET requests, JSON responses.

https://www.dekseen.uz/v1

🌍

Mamlakatlar ro'yxatiСписок странGet Countries

ParametrПараметрParameter	QiymatЗначениеValue	TavsifОписаниеDescription
key	—	Sizning API kalitingizВаш API ключYour API key
action	getCountrys	—

               Request
              
GET https://www.dekseen.uz/v1?key=YOUR_KEY&action=getCountrys

               JSON Response
              
            
{
  "ok": true,
  "result": {
    "countries": {
      "telegram": {
        "PS": "12500.00",
        "RU": "15000.00",
        "ID": "13000.00"
      },
      "whatsapp": {
        "PS": "14000.00",
        "US": "18000.00"
      }
    }
  }
}

💡

EslatmaПримечаниеNote Narxlar sizning valyutangizda (UZS, USD, RUB). 15% ustama allaqachon qo'shilgan. Цены отображаются в вашей валюте (UZS, USD, RUB). 15% наценка уже включена. Prices are in your currency (UZS, USD, RUB). 15% markup is already included.

📱

Nomer olishПолучить номерGet Number

ParametrПараметрParameter	QiymatЗначениеValue	TavsifОписаниеDescription
key	—	API kalitingizВаш API ключYour API key
action	getNumber	—
country	`PS, RU, US...`	Mamlakat kodiКод страныCountry code

               Request
              
GET https://www.dekseen.uz/v1?key=YOUR_KEY&action=getNumber&country=PS

✅ Muvaffaqiyatli javob✅ Успешный ответ✅ Success response

               JSON
              
            
{
  "ok": true,
  "result": {
    "number":      "+970123456789",
    "hash_code":   "abc123xyz789",
    "price":       "12500.00",
    "currency":    "UZS",
    "deducted":    true,
    "new_balance": "87500.00"
  }
}

❌ Xato — balans kam❌ Ошибка — недостаточно баланса❌ Error — insufficient balance

               JSON
              
            
{
  "ok":    false,
  "error": "INSUFFICIENT_BALANCE",
  "msg":   "Hisobingizda yetarli mablag' yo'q!"
}

⚠️

MuhimВажноImportant Nomer olinganda balansdan avtomatik pul yechiladi. Oldindan balansni tekshiring. При получении номера баланс списывается автоматически. Проверяйте баланс заранее. Balance is deducted automatically when getting a number. Check balance beforehand.

💬

SMS kodi olishПолучить SMS кодGet SMS Code

ParametrПараметрParameter	QiymatЗначениеValue	TavsifОписаниеDescription
key	—	API kalitingizВаш API ключYour API key
action	getCode	—
hash_code	—	getNumber dan kelgan hashHash из getNumberHash from getNumber

               Request
              
GET https://www.dekseen.uz/v1?key=YOUR_KEY&action=getCode&hash_code=abc123

               JSON Response
              
            
{
  "ok": true,
  "result": {
    "code":   "123456",
    "status": "received"
  }
}

💰

Balans tekshirishПроверить балансGet Balance

ParametrПараметрParameter	QiymatЗначениеValue
key	—
action	getBalance

               JSON Response
              
            
{
  "ok": true,
  "result": {
    "balance":     625.00,
    "balance_uzs": 100000.00,
    "currency":    "RUB"
  }
}

💡

EslatmaПримечаниеNote Balans UZS da saqlanadi, sizning valyutangizda ko'rsatiladi. Баланс хранится в UZS, отображается в вашей валюте. Balance is stored in UZS, displayed in your currency.

👤

Foydalanuvchi ma'lumotlariИнформация о пользователеUser Info

ParametrПараметрParameter	QiymatЗначениеValue
key	—
action	getInfo

               JSON Response
              
            
{
  "ok": true,
  "result": {
    "user_id":     "12345",
    "telegram_id": "6302762403",
    "status":      "active",
    "balance":     625.00,
    "currency":    "RUB",
    "api_key":     "719a***********9c"
  }
}

⚠️

Xato kodlariКоды ошибокError Codes

Xato kodiКод ошибкиError code	Ma'nosiЗначениеMeaning
API_KEY_EMPTY	API kalit kiritilmaganAPI ключ не указанAPI key not provided
INVALID_KEY	API kalit noto'g'riНеверный API ключInvalid API key
INSUFFICIENT_BALANCE	Balans yetarli emasНедостаточно средствInsufficient balance
API_ERROR	Tashqi API xatosiОшибка внешнего APIExternal API error
DB_ERROR	Ma'lumotlar bazasi xatosiОшибка базы данныхDatabase error

💻

Kod misollariПримеры кодаCode Examples

PHP

           PHP
          
        
<?php
$apiKey  = 'YOUR_API_KEY';
$baseUrl = 'https://www.dekseen.uz/v1';

// 1. Get number
$res  = file_get_contents("$baseUrl?key=$apiKey&action=getNumber&country=PS");
$data = json_decode($res, true);

if ($data['ok']) {
    $number   = $data['result']['number'];
    $hashCode = $data['result']['hash_code'];
    echo "Number: $number\n";

    sleep(30); // wait for SMS

    // 2. Get SMS code
    $codeRes  = file_get_contents("$baseUrl?key=$apiKey&action=getCode&hash_code=$hashCode");
    $codeData = json_decode($codeRes, true);

    if ($codeData['ok']) {
        echo "Code: " . $codeData['result']['code'];
    }
}
?>

Python

           Python
          
        
import requests, time

API_KEY  = 'YOUR_API_KEY'
BASE_URL = 'https://www.dekseen.uz/v1'

# 1. Get number
r = requests.get(BASE_URL, params={
    'key': API_KEY, 'action': 'getNumber', 'country': 'PS'
}).json()

if r['ok']:
    number    = r['result']['number']
    hash_code = r['result']['hash_code']
    print(f'Number: {number}')

    time.sleep(30)  # wait for SMS

    # 2. Get SMS code
    code = requests.get(BASE_URL, params={
        'key': API_KEY, 'action': 'getCode', 'hash_code': hash_code
    }).json()

    if code['ok']:
        print(f"Code: {code['result']['code']}")

💱

Ko'p valyuta tizimiМультивалютная системаMulti-Currency

✅

Qanday ishlaydiКак работаетHow it works Balans UZS da saqlanadi. Ko'rsatishda database kursi asosida sizning valyutangizga konvertatsiya qilinadi. Баланс хранится в UZS. При отображении конвертируется в вашу валюту по курсу из базы данных. Balance is stored in UZS. Displayed in your currency based on database exchange rates.

🇺🇿

UZS

1 UZS = 1 UZS

100,000 UZS = 100,000 UZS

🇺🇸

USD

1 USD ≈ 12,800 UZS

100,000 UZS ≈ $7.81

🇷🇺

RUB

1 RUB ≈ 160 UZS

100,000 UZS ≈ 625 ₽

SMS APIHujjatlarДокументацияDocumentation

SMS API
HujjatlarДокументацияDocumentation