Изменение статуса активации
Метод 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-запрос к указанному URLconst data = await response.json();# Выводим содержимое ответа от сервераconsole.log(data);} catch (err) {# Если произошла ошибка, выводим сообщение об ошибкеconsole.error(err);}Возможные ошибки
| Параметр | Описание |
|---|---|
| Неверный API-ключ | |
| Некорректное действие | |
| Ошибка в запросе | |
| Время на которое аккаунт заблокирован | |
| Аккаунт не активен | |
| Нельзя отменить номер в первые 2 минуты | |
| Активация не найдена | |
| Некорректный статус | |
| Неверный ID или ID не является числом. |