Зміна статусу активації

Метод setStatus дозволяє керувати станом активації віртуального номера через API SMS.online. Він використовується для зміни поточного статусу номера в системі, наприклад, при завершенні активації або скасуванні використання номера.

Цей метод корисний для автоматизації процесів, пов'язаних з управлінням віртуальними номерами, коли потрібно оперативно оновлювати статус активації в реальному часі.

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

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

Вхідні дані

ПараметрОбов'язковийПриміткаОпис
ТакДив. у профілі в налаштуваннях API КлючAPI-ключ забезпечує доступ до оплачуваних послуг
ТакsetStatusНазва методу
ТакЧислове значенняID активації, отримане при запиті номера
ТакЧислове значенняСтатус активації

Коли який статус надсилати?

Одразу після отримання номера, номер знаходиться в очікуванні SMS.

Вам доступні такі дії:

8 - Скасувати активацію

Одразу після отримання коду:

3 - Запросити ще одну смс

6 - Підтвердити SMS-код і завершити активацію

Для активації зі статусом 3:

6 - Підтвердити SMS-код і завершити активацію

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

Відповідь сервераОпис
Очікується повторна активація
Активація успішно завершена
Активація скасована

Приклад коду

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

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

ПараметрОпис
Невірний API-ключ
Некоректна дія
Помилка в запиті
Час, на який аккаунт заблоковано
Аккаунт не активний
Не можна скасувати номер у перші 2 хвилини
Активація не знайдена
Некоректний статус
Невірний ID або ID не є числом.