Публичный API VioSMS

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

Аутентифицируйте запросы, включая секретный API ключ в заголовок Authorization.

HTTP Header

Authorization: Bearer YOUR_API_KEY

GET/api/v1/balance

Возвращает текущий баланс счета.

Ответ

{
  "status": "success",
  "balance": 15.50,
  "currency": "USD"
}

GET/api/v1/services

Возвращает список всех доступных сервисов и их минимальные цены.

Примечание: Если вы ищете конкретный сервис, например Hinge или Tinder, используйте эту конечную точку для динамического получения всех доступных кодов сервисов.

Ответ

{
  "status": "success",
  "data": [
    {
      "code": "wa",
      "name": "WhatsApp",
      "price": 0.25
    }
  ]
}

GET/api/v1/countries

Получите список всех доступных стран и их кодов. Вы должны использовать code из этого ответа при покупке номера.

Ответ

{
  "status": "success",
  "data": [
    {
      "code": "turkey",
      "name": "Turkey"
    },
    {
      "code": "62",
      "name": "Indonesia"
    }
  ]
}

POST/api/v1/buy

Покупает новый номер телефона. Стоимость будет списана с вашего баланса.

Параметр	Интегрируйте VioSMS в свои приложения для автоматической покупки и подтверждения номеров. Все эндпоинты требуют API ключ.
servicestring*	Код сервиса (например, "wa" для WhatsApp).
countrystring*	Код страны (например, "161" для Турции).
operatorstring	Опциональный код оператора. По умолчанию "any".

Запрос

{
  "service": "wa",
  "country": "161"
}

Ответ

{
  "status": "success",
  "data": {
    "id": "cuid...",
    "phone": "+1234567890",
    "price": 1.25,
    "expiresAt": "2026-06-05T12:00:00.000Z"
  }
}

GET/api/v1/status

Проверяет статус SMS-верификации активации.

Параметр	Интегрируйте VioSMS в свои приложения для автоматической покупки и подтверждения номеров. Все эндпоинты требуют API ключ.
idstring*	Уникальный ID активации, возвращенный при покупке.

Ответ

{
  "status": "success",
  "data": {
    "id": "cuid...",
    "status": "SMS_RECEIVED",
    "phone": "+1234567890",
    "smsCode": "456789",
    "smsText": "WhatsApp code: 456789"
  }
}

POST/api/v1/cancel

Отменяет активацию и возвращает средства, если SMS не было получено.

Параметр	Интегрируйте VioSMS в свои приложения для автоматической покупки и подтверждения номеров. Все эндпоинты требуют API ключ.
idstring*	Уникальный ID активации для отмены.

Запрос

{
  "id": "cuid..."
}

Ответ

{
  "status": "success",
  "message": "Activation cancelled and refunded"
}