Запрос номера в аренду
Метод getRentNumber используется для аренды виртуального номера на определённый период через API SMS.online. Он позволяет автоматизировать процесс получения номера для приёма SMS в заданной стране и от указанного сервиса. Вы можете указать параметры страны, сервиса и (опционально) оператора для выбора доступного номера с долгосрочным использованием.
Метод подходит для ситуаций, когда требуется постоянный виртуальный номер на несколько дней, недель или месяцев. Это позволяет интегрировать номер в системы, где необходим стабильный канал приёма SMS в течение длительного периода.
Успешный запрос возвращает объект с информацией о номере, включая его идентификатор, срок аренды и стоимость. Метод особенно полезен для приложений и сервисов с длительным циклом взаимодействия, где требуется постоянный доступ к одному номеру.
Пример запроса:
Входные данные
| Параметр | Обязательный | Примечание | Описание |
|---|---|---|---|
| Да | См. в профиле в настройках API Ключ | API-ключ обеспечивает доступ к оплаченным услугам | |
| Да | getRentNumber | Название метода | |
| Да | См. список сервисов в левом меню | Сервис, номер для которого необходимо получить | |
| Да | См. список стран в левом меню | Страна, номер которой необходимо получить | |
| Нет | См. список операторов в левом меню | Сотовый оператор, номер которого необходимо получить | |
| Нет | 4, 8, 12, 24, 72, 168, 360, 720, 2160 | Время аренды в часах | |
| Нет | - | Ссылка для webhook (по умолчанию не учитывается) |
Ответ сервера
{
"status": "success",
"phone": {
"id": 1,
"endDate": "2025-05-10T12:34:56",
"number": "79999876543"
}
}Пример кода
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=getRentNumber&service=${service}&country=${country}`);# Выполняем GET-запрос к указанному URLconst data = await response.json();# Выводим содержимое ответа от сервераconsole.log(data);} catch (err) {# Если произошла ошибка, выводим сообщение об ошибкеconsole.error(err);}Возможные ошибки
| Параметр | Описание |
|---|---|
| Некорректное действие | |
| Неверный API-ключ | |
| Ошибка в запросе | |
| Время на которое аккаунт заблокирован | |
| Аккаунт не активен | |
| Некорректное наименование страны | |
| Некорректное наименование сервиса | |
| Некорректное время | |
| Баланс не найден | |
| Нет доступных номеров | |
| Аккаунт заблокирован |