FAQAPI

Список активных арендованных номеров

Метод getRentList используется для получения актуального списка всех арендованных виртуальных номеров, привязанных к вашей учётной записи через API SMS.online. Он позволяет в реальном времени отслеживать активные аренды и контролировать использование ресурсов.

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

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

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

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

ПараметрОбязательныйПримечаниеОписание
ДаСм. в профиле в настройках API КлючAPI-ключ обеспечивает доступ к оплаченным услугам
ДаgetRentListНазвание метода
ДаЧисловое значениеID аренды, полученное при запросе номера

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

JSON
{
  "status": "success", 
  "values": [
    { 
      "id": "12345", 
      "phone": "79181234567",
      "price": "100",
      "hours": "4"
    }, 
    { 
      "id": "12345", 
      "phone": "79181234568",
      "price": "100",
      "hours": "4"
    } 
  ]
}

Пример кода

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

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

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