FAQAPI

Отримання історії оренди

Метод getRentHistory використовується для отримання повного списку всіх орендованих віртуальних номерів, пов'язаних з обліковим записом через API SMS.online. Це дозволяє автоматизувати аналіз використання номерів у довгостроковій оренді та відстежувати витрати на продовження.

Метод надає можливість отримати детальну інформацію про оренду, включаючи дату початку, термін дії, номер телефону, статус оренди та вартість продовження. Це дозволяє контролювати поточні та завершені оренди, а також оцінювати витрати на тривале використання номерів.

Успішний запит повертає структурований об'єкт зі списком усіх орендованих номерів, включаючи унікальний ідентифікатор оренди, дату початку, термін дії, номер телефону, поточний статус і суму оренди. Метод оптимальний для систем аналітики та моніторингу витрат на оренду.

Приклад запиту:

Вхідні дані

ПараметрОбов'язковийПриміткаОпис
ТакДив. у профілі в налаштуваннях API КлючAPI-ключ забезпечує доступ до оплачуваних послуг
ТакgetRentHistoryНазва методу
НіЧасова мітка у форматі Unix TimestampЗ якої дати брати активації (обмежено 30 днями)
НіЧасова мітка у форматі Unix TimestampПо яку дату брати активації (обмежено 30 днями)
НіЧислове значенняЗсув першого елемента, що повертається в відповіді (за замовчуванням 0)
НіЧислове значенняКількість елементів, що повертаються в відповіді (за замовчуванням 50, максимум 100)

Відповідь сервера

JSON
[
  {
    "id": 635468024,
    "date": "2022-11-12 15:58:39",
    "phone": "79918529716",
    "sms": "["Your sms code"]",
    "cost": 100
    "status": "4"
  }
]

Приклад коду

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

Можливі помилки

ПараметрОпис
Некоректна дія
Невірний API-ключ
Помилка в запиті
Час, на який аккаунт заблоковано
Аккаунт не активний
Некоректна дата