FAQAPI

Продление аренды виртуального номера

Метод continueRentNumber используется для продления срока аренды виртуального номера через API SMS.online. Он позволяет автоматизировать процесс продления, обеспечивая непрерывное использование арендованного номера для приёма SMS без риска его потери.

Метод предназначен для ситуаций, когда требуется продолжительное использование одного и того же номера. Вы можете указать период продления, после чего система обновит срок действия аренды и предоставит подтверждение об успешном продлении.

Успешный запрос возвращает объект с информацией об обновлённой аренде, включая идентификатор номера, новый срок действия аренды и сумму списания. Это позволяет обеспечить стабильность приёма SMS на протяжении продлённого периода.

Пример запроса:

Входные данные

ПараметрОбязательныйПримечаниеОписание
ДаСм. в профиле в настройках API КлючAPI-ключ обеспечивает доступ к оплаченным услугам
ДаcontinueRentNumberНазвание метода
ДаЧисловое значениеID активации, полученное при запросе номера
Да4, 8, 12, 24, 72, 168, 360, 720, 2160Время аренды в часах

Ответ сервера

JSON
{
  "status": "success",
  "phone": {
    "id": 1049,
    "endDate": "2020-01-31T12:01:52",
    "number": "79959707564"
  }
}

Пример кода

const api_key = "API_KEY"; # Замените 'API_KEY' на ваш реальный API-ключ.
const id = 1; # Вставьте ID активации, полученное при запросе номера
const rent_time = 1; # Вставьте время продления в часах из таблицы выше
try {
const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=continueRentNumber&id=${id}&rent_time=${rent_time}`);
# Выполняем GET-запрос к указанному URL
const data = await response.json();
# Выводим содержимое ответа от сервера
console.log(data);
} catch (err) {
# Если произошла ошибка, выводим сообщение об ошибке
console.error(err);
}

Возможные ошибки

ПараметрОписание
Некорректное действие
Неверный API-ключ
Ошибка в запросе
Время на которое аккаунт заблокирован
Аккаунт не активен
Не указан ID аренды
Номер арендован не вами (неправильный ID аренды)
Некорректное время продления
Баланс не найден
Отсутствует или неправильно указан статус