single-service activations

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

GEThttps://onlinesim.io/stubs/handler_api.php?action=getNumber

Заказывает номер страны для приема SMS от сервиса. Цена резервируется на балансе. Ответ содержит ID операции (id для getStatus, getFullSms и setStatus) и номер с кодом страны.

Ошибки:

  • BAD_COUNTRY — country нет в getCountries, либо он не число
  • WRONG_SERVICE — service не указан или не продается в этой стране
  • NO_BALANCE — недостаточно денег на балансе
  • NO_NUMBERS — сейчас нет номеров для этого сервиса и страны (также когда все исключены через phoneException)
  • WARNING_WAIT15MIN — открыто слишком много операций без SMS
  • и общие ошибки

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

Параметры

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

Имя метода: getNumber

Перечисление:getNumber
service*string

Код сервиса: ключ getNumbersStatus без _0 (например, go для Google) или slug сервиса Onlinesim

Пример:go
countryinteger
≥ 0

ID страны из getCountries (id). Без него или 0: Россия

По умолчанию:0Пример:16
phoneExceptionstring

Префиксы номеров (с кодом страны), которые не должны выдаваться: список через запятую (phoneException=4479,4475) или массив (phoneException[]=4479&phoneException[]=4475)

Пример:4479,4475

Ответы

200ACCESS_NUMBER:<ID операции>:<номер> или ошибка
Content-Typetext/plain
Схема
schemaoneOf
Одно из
[0]string
Шаблон:^ACCESS_NUMBER:\d+:\d+$
[1]string
Перечисление:BAD_COUNTRYWRONG_SERVICENO_BALANCENO_NUMBERSWARNING_WAIT15MIN
[2]string
Ошибка, которую любой метод (в том числе JSON-методы) возвращает текстом:
  • BAD_KEY — API ключ неверный или отсутствует
  • BANNED — аккаунт заблокирован
  • BAD_ACTION — неизвестный метод или ошибка без собственного кода (например, временная ошибка или слишком много одновременных запросов); проверьте запрос и повторите его позже
  • Too many requests. Please wait a moment before trying again. — лимит конвертера для getNumber, getRentNumber, setStatus и setRentStatus (3 запроса в секунду, 150 за 30 секунд)
Перечисление:BAD_KEYBANNEDBAD_ACTIONToo many requests. Please wait a moment before trying again.

Примеры

number

Номер выдан

ACCESS_NUMBER:65904893:447400123456
noNumbers

Сейчас нет номеров

NO_NUMBERS
noBalance

Недостаточно денег

NO_BALANCE

Примеры кода

Генерация примеров...