SMS API Documentation

🌍

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

#01

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

So'rov namunasiПример запросаRequest example

GET https://694bccc3c315b.myxvest1.ru/v1?key=YOUR_API_KEY&action=getCountrys

Javob namunasiПример ответаResponse example

{
  "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 ko'rsatiladi (UZS, USD, RUB). 15% ustama qo'shilgan. Цены показаны в вашей валюте (UZS, USD, RUB). Включает 15% наценку. Prices shown in your currency (UZS, USD, RUB). Includes 15% markup.

📱

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

#02

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

So'rov namunasiПример запросаRequest example

GET https://694bccc3c315b.myxvest1.ru/v1?key=YOUR_API_KEY&action=getNumber&country=PS

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

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

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

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

⚠️ Muhim:Важно:Important: Nomer olinganda balansdan avtomatik pul yechiladi. Oldindan balans yetarliligini tekshiring! При получении номера баланс автоматически списывается. Проверьте баланс перед запросом! Balance is automatically deducted when getting a number. Check balance before requesting!

💬

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

#03

ParametrПараметрParameter	TavsifОписаниеDescription
key	Sizning API kalitingiz	Ваш API ключ	Your API key
action	getCode
hash_code	getNumber dan kelgan hash kod	Hash код из getNumber	Hash code from getNumber

So'rov namunasiПример запросаRequest example

GET https://694bccc3c315b.myxvest1.ru/v1?key=YOUR_API_KEY&action=getCode&hash_code=abc123xyz

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

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

💰

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

#04

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

Javob namunasiПример ответаResponse example

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

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

👤

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

#05

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

Javob namunasiПример ответаResponse example

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

⚠️

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

#06

Xato kodiКод ошибкиError Code	TavsifОписаниеDescription
API_KEY_EMPTY	API kalit kiritilmagan	API ключ не указан	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 xato	Ошибка внешнего API	External API error
DB_ERROR	Database xato	Ошибка базы данных	Database error

💻

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

#07

PHP

PHP Example

<?php
$apiKey = 'YOUR_API_KEY';
$baseUrl = 'https://694bccc3c315b.myxvest1.ru/v1';

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

if ($data['ok']) {
    echo "Number: " . $data['result']['number'];
    sleep(30); // Wait for SMS
    
    // Get code
    $code = file_get_contents("$baseUrl?key=$apiKey&action=getCode&hash_code=" . $data['result']['hash_code']);
    echo $code;
}
?>

Python

Python Example

import requests
import time

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://694bccc3c315b.myxvest1.ru/v1'

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

data = response.json()
if data['ok']:
    print(f"Number: {data['result']['number']}")
    time.sleep(30)  # Wait for SMS
    
    # Get code
    code_response = requests.get(BASE_URL, params={
        'key': API_KEY,
        'action': 'getCode',
        'hash_code': data['result']['hash_code']
    })
    print(code_response.json())

💱

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

#08

Qanday ishlaydi:Как работает:How it works:

Balans: UZS da saqlanadi
Ko'rsatish: Sizning valyutangizda
Konvertatsiya: Database kurs asosida
Баланс: Хранится в UZS
Отображение: В вашей валюте
Конвертация: По курсу из базы
Storage: All in UZS
Display: In your currency
Conversion: Based on database rates

ValyutaВалютаCurrency	Kurs (UZS ga)Курс (к UZS)Rate (to UZS)	MisolПримерExample
🇺🇿 UZS	1	100,000 UZS = 100,000 UZS
🇺🇸 USD	12,800	100,000 UZS = 7.81 USD
🇷🇺 RUB	160	100,000 UZS = 625 RUB