Оренда віртуального номера
Метод 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-ключ | |
| Помилка в запиті | |
| Час, на який аккаунт заблоковано | |
| Аккаунт не активний | |
| Некоректна назва країни | |
| Некоректна назва сервісу | |
| Некоректний час | |
| Баланс не знайдено | |
| Немає доступних номерів | |
| Аккаунт заблоковано |