Skip to content

GET /api/getNum.php

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

Запрашивает номер для приема SMS от выбранного сервиса.

Позволяет заказать номер выбранной страны для получения SMS-сообщения от конкретного сайта/приложения.

По своей сути является аналогом кнопки покупки номера, расположенной в личном кабинете.

WARNING

Вы также можете указать дополнительные параметры, например, исключения для маски номера на случай, если у сервиса есть подобные требования.

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

В таком случае этот параметр может помочь Вам обойти блокировку.

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

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

Параметры

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

‘Название сервиса (может принимать лишь значения сервисов,
указанные в
списке)’

Пример:facebook
countryinteger
≥ 1

‘Международный телефонный код страны (согласно стандарту
E.164, без знака “+”), смотри список
стран

По умолчанию:7Пример:46
rejectstring[]

Массив исключений для масок номеров (включая код страны) Например: при передаче [911, 912123] не будет выдавать номера Индии, начинающиеся с +911* и +912123*.

Пример:["911"]
dev_idinteger

ID аккаунта для разработчиков ПО (ID профиля Onlinesim).

Пример:100000
numberboolean

Отображать номер в ответе сервера. При переданном значении
true запрос вернет номер заказанного телефона в ответе.

Пример:false
langstring

Язык ответа:

fr - французский,

de - немецкий,

ru - русский,

en - английский,

zh - китайский.
Обратите внимание, что перевод производится лишь для строковых значений полей, например, названий сервисов или стран. Сами названия полей, ошибки выполнения запросов и общепринятые значения (например, значения полей true/false для булевых параметров) остаются на английском языке.

Перечисление:frderuenzhПо умолчанию:ruПример:en

Ответы

200

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

Примеры кода