Заказ номера
Метод getNumber используется для получения одноразового виртуального номера через API SMS.online. Он позволяет автоматически запрашивать номер для верификации на сторонних платформах, требующих подтверждения через SMS. Метод принимает параметры страны, сервиса и (опционально) оператора для точного выбора номера.
При успешном выполнении запроса возвращается строка с уникальным идентификатором активации и самим номером. Метод предназначен для интеграции в системы автоматической регистрации и подтверждения учётных записей через SMS.
Пример запроса:
Входные данные
| Параметр | Обязательный | Примечание | Описание |
|---|---|---|---|
| Да | См. в профиле в настройках API Ключ | API-ключ обеспечивает доступ к оплаченным услугам | |
| Да | getNumber | Название метода | |
| Да | См. список сервисов в левом меню | Сервис, номер для которого необходимо получить | |
| Да | См. список стран в левом меню | Страна, номер которой необходимо получить | |
| Нет | См. список операторов в левом меню | Сотовый оператор, номер которого необходимо получить | |
| Нет | См. в Партнерской программе | Реферальный ID | |
| Нет | Числовое значение | Тип активации: 0 - смс (по умолчанию), 1 - по номеру, 2 - по голосу |
Ответ сервера
ACCESS_NUMBER:ID:NUMBERПолучили номер, ID активации - ID, сам номер с кодом страны - NUMBER
Пример кода
const api_key = "API_KEY"; # Замените 'API_KEY' на ваш реальный API-ключ.const service = "SERVICE"; # Замените 'SERVICE' на идентификатор сервиса. Все идентификаторы можно просмотреть в документации в списке в левом меню.const country = 1; # Вставьте номер нужной страны. Номера всех стран можно просмотреть в документации в списке в левом меню.try {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getNumber&service=${service}&country=${country}`);# Выполняем GET-запрос к указанному URLconst data = await response.json();# Выводим содержимое ответа от сервераconsole.log(data);} catch (err) {# Если произошла ошибка, выводим сообщение об ошибкеconsole.error(err);}Возможные ошибки
| Параметр | Описание |
|---|---|
| Некорректное действие | |
| Неверный API-ключ | |
| Ошибка в запросе | |
| Время на которое аккаунт заблокирован | |
| Аккаунт не активен | |
| Некорректное наименование сервиса | |
| Некорректное наименование страны | |
| Аккаунт заблокирован | |
| Нет доступных номеров | |
| Баланс не найден |