Разработчикам

API для разработчиков

Автоматизируйте покупку номеров и получение OTP-кодов с помощью лаконичного REST API и единого ключа.

Base URLhttps://xthonvirtual.store/api/v2

Аутентификация

Отправляйте свой персональный API-ключ в заголовке каждого запроса. Получите его в боте в разделе 🔑 API.

X-API-Key: YOUR_API_KEY

Быстрый старт

Проверьте баланс, затем: получите список сервисов → купите номер → запрашивайте код.

curl -X GET "https://xthonvirtual.store/api/v2/balance" \
  -H "X-API-Key: YOUR_API_KEY"

Эндпоинты

GET/balance

Получить текущий баланс и бонусный уровень.

curl -X GET "https://xthonvirtual.store/api/v2/balance" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "ok": true,
  "data": { "balance": "12.50", "bonus": 10 }
}

GET/services

Список активных сервисов с их ценой и наличием в реальном времени.

curl -X GET "https://xthonvirtual.store/api/v2/services" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "ok": true,
  "data": [
    { "id": "8f3c…", "name": "Telegram", "price": "1.20", "stock": 42 }
  ]
}

POST/services/{service_id}/buy

Зарезервировать и купить один номер сервиса.

curl -X POST "https://xthonvirtual.store/api/v2/services/{service_id}/buy" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "ok": true,
  "data": {
    "id": "tx_91a…", "status": "PENDING",
    "price": "1.20", "number": "+15550001", "code": null
  }
}

GET/transactions/{id}

Получить транзакцию (номер), которой вы владеете.

curl -X GET "https://xthonvirtual.store/api/v2/transactions/{id}" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "ok": true,
  "data": { "id": "tx_91a…", "status": "PENDING", "number": "+15550001", "code": null }
}

GET/transactions/{id}/code

Запрашивать OTP-код — возвращает null, пока он не придёт.

curl -X GET "https://xthonvirtual.store/api/v2/transactions/{id}/code" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "ok": true,
  "data": { "id": "tx_91a…", "status": "SUCCEEDED", "code": "54321" }
}

POST/transactions/{id}/cancel

Вернуть средства за номер в статусе PENDING, на который так и не пришёл код.

curl -X POST "https://xthonvirtual.store/api/v2/transactions/{id}/cancel" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "ok": true,
  "data": { "refunded": "1.20" }
}

Опт через API-токены

Закупаете большими объёмами? Используйте API-токены, чтобы покупать номера оптом программно — с лучшей ценой за единицу и выделенной поддержкой для реселлеров.

Свяжитесь с нами по оптовым закупкам

Коды статуса

200	Успешно
401	Отсутствует или неверный API-ключ
402	Недостаточно средств
404	Не найдено
409	Нет в наличии