Skip to content

GET /stubs/handler_api.php?action=getNumber

Купить виртуальный номер для выбранного сервиса

Этот запрос позволяет Вам заказать виртуальный номер определенной страны для приема SMS от выбранного Вами сервиса (сайта, мобильного приложения и пр.). Это основная услуга, предоставляемая Onlinesim: Вы можете использовать виртуальные номера для приема кодов верификации или любой другой информации, содержащейся в SMS-сообщениях.

WARNING

Пожалуйста, учтите, что номер выдается на 15 минут (окончательный срок зависит от сервиса и страны и может отличаться от указанного значения) и после закрытия операции становится недоступен.

Безопасность

  • api_key
  • BearerAuth
  • OAuth2 (Области: sms-scope)
    • sms-scope: grants access to manage numbers for the SMS receiving service from Onlinesim

Параметры

НазваниеТипОписание
action*string

Имя метода, в данном случае getNumber

Перечисление:getNumberПо умолчанию:getNumber
service*string

Slug сервиса (короткое название сервиса, необходимо для заказа смотри getNumbersStatus)

Пример:3223
country*integer

ID страны (смотри запрос getCountries)

По умолчанию:7Пример:46
phoneExceptiononeOf

Массив префиксов-исключений для маски номера (вместе с кодом
страны)

Например, при значении [911,912123] не будет выдавать номера Индии,
начинающиеся с 911* и 912123*

Пример:908

Ответы

200

Успешный ответ от сервера на запрос getNumber: либо
возвращает ID операции и выдает виртуальный номер для приема SMS от
указанного сервиса, либо выбрасывает исключение.

Примеры кода