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 оренди)
Некоректний час продовження
Баланс не знайдено
Відсутній або неправильно вказаний статус