Замовлення номера
Метод getNumber використовується для отримання одноразового віртуального номера через API SMS.online. Він дозволяє автоматично запитувати номер для верифікації на сторонніх платформах, які вимагають підтвердження через SMS. Метод приймає параметри країни, сервісу та (за бажанням) оператора для точного вибору номера.
При успішному виконанні запиту повертається рядок з унікальним ідентифікатором активації та самим номером. Метод призначений для інтеграції в системи автоматичної реєстрації та підтвердження облікових записів через SMS.
Приклад запиту:
Вхідні дані
| Параметр | Обов'язковий | Примітка | Опис |
|---|---|---|---|
| Так | Див. у профілі в налаштуваннях API Ключ | API-ключ забезпечує доступ до оплачуваних послуг | |
| Так | getNumber | Назва методу | |
| Так | Див. список сервісів у лівому меню | Сервіс, номер для якого потрібно отримати | |
| Так | Див. список країн у лівому меню | Країна, номер якої потрібно отримати | |
| Ні | Див. список операторів у лівому меню | Мобільний оператор, номер якого потрібно отримати | |
| Ні | Див. у Партнерській програмі | Реферальний ID | |
| Ні | Числове значення | Тип активації: 0 - смс (за замовчуванням), 1 - за номером, 2 - за голосом |
Відповідь сервера
ACCESS_NUMBER:ID:NUMBERОтримали номер, ID активації - ID, сам номер з кодом країни - NUMBER
Приклад коду
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=getNumber&service=${service}&country=${country}`);# Виконуємо GET-запит до вказаного URLconst data = await response.json();# Виводимо вміст відповіді від сервераconsole.log(data);} catch (err) {# Якщо сталася помилка, виводимо повідомлення про помилкуconsole.error(err);}Можливі помилки
| Параметр | Опис |
|---|---|
| Некоректна дія | |
| Невірний API-ключ | |
| Помилка в запиті | |
| Час, на який аккаунт заблоковано | |
| Аккаунт не активний | |
| Некоректна назва сервісу | |
| Некоректна назва країни | |
| Аккаунт заблоковано | |
| Немає доступних номерів | |
| Баланс не знайдено |