get getNum

https://onlinesim.io/api/getNum.php
single-service activations

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

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

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

ВАЖНО!

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

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

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

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

Parameters

service
Обязательный

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

В: query
Схема:
  • string
    Пример: "facebook"
country

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

В: query
Схема:
  • integer
    Пример: 46
    >= 1
reject
Массив исключений для масок номеров (включая код страны) Например: при передаче [911, 912123] не будет выдавать номера Индии, начинающиеся с +911* и +912123*.
В: query
Схема:
  • array<string>
    Пример: ["911"]
    Items:
    • string
      Пример: "string"
dev_id
ID аккаунта для разработчиков ПО (ID профиля Onlinesim).
В: query
Схема:
  • integer
    Пример: 100000
number
Отображать номер в ответе сервера. При переданном значении `true` запрос вернет номер заказанного телефона в ответе.
В: query
Схема:
  • boolean
    Пример: false
lang

Язык ответа:

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

de - немецкий,

ru - русский,

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

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

В: query
Схема:
  • string
    Пример: "en"
    Перечисление: fr de ru en zh

Ответы

200

Успешный ответ на запрос `getNum`: сервер выдает виртуальный номер для приема SMS от указанного сервиса или выбрасывает исключение.
Тип содержимого:
application/json
  • Schema
  • Examples
  • object
    Пример: {"response":1,"tzid":10000}
    Свойства:
    • response
      mixed
      Обязательный
      1, если запрос был выполнен успешно, либо выведет сообщение об ошибке
      Пример: 1
      Одно из:
      • integer
        Пример: 0
      • string
        Пример: "string"
    • tzid
      integer
      Обязательный
      ID операции
      Пример: 10000
      >= 1