FAQAPI

Запросить доступные страны и сервисы

Метод getRentPrices используется для получения актуального перечня стран и сервисов, доступных для аренды виртуальных номеров через API SMS.online. Он обеспечивает автоматизацию выбора страны и сервиса при аренде номера.

Метод рекомендуется для систем, которые требуют динамического формирования списка направлений перед созданием запроса на аренду. Используя данный метод, можно получить актуальный список стран и связанных с ними сервисов для интеграции в автоматизированные процессы.

Успешный запрос возвращает структурированные данные, включающие список стран, поддерживаемых сервисов и операторов. Это позволяет реализовать гибкий выбор аренды номеров в автоматизированных системах.

Пример запроса:

Входные данные

ПараметрОбязательныйПримечаниеОписание
ДаСм. в профиле в настройках API КлючAPI-ключ обеспечивает доступ к оплаченным услугам
ДаgetRentPricesНазвание метода
ДаСм. список стран в левом менюСтрана, номер которой необходимо получить

Ответ сервера

JSON
{
  "status": "success", 
  "values": { 
    "Страна": { 
      "Сервис": { 
        "cost": Стоимость, 
        "count": Количество
      }
    }
  }
}

Пример кода

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

Возможные ошибки

ПараметрОписание
Некорректное действие
Неверный API-ключ
Ошибка в запросе
Время на которое аккаунт заблокирован
Аккаунт не активен
Закончились номера для этой страны