rent

Арендовать номер

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

Арендует номер страны для приема SMS от любых отправителей. Цена аренды за период резервируется на балансе и списывается с первым SMS. Аренда заказывается без опции продления.

Ошибки в JSON ({"status":"error","message":…}):

  • NO_NUMBERS — сейчас нет свободного номера, или в стране нет аренды на этот период
  • NO_BALANCE — недостаточно денег на балансе

Ошибки текстом: BAD_COUNTRY (неизвестный или нечисловой country) и общие ошибки.

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

OAuth2
rent-scope
grants access to renting phone numbers from Onlinesim

Параметры

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

Имя метода: getRentNumber

Перечисление:getRentNumber
countryinteger
≥ 0

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

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

Срок аренды в часах, округляется вверх до целых дней (2 → 1 день, 25 → 2 дня); 0 означает 24. Число дней должно быть периодом аренды страны

По умолчанию:4Пример:24

Ответы

200Арендованный номер или ошибка
text/plain
Схема
schemaoneOf
Одно из
[0]string
Перечисление:BAD_COUNTRY
[1]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.
application/json
Схема
schemaoneOf
Одно из
[0]object
[1]objectОшибка JSON-метода. Коды перечислены у каждого метода

Примеры

rented

Номер арендован

{
  "status": "success",
  "phone": {
    "id": 22867858,
    "endDate": "2026-11-20T10:00:00+03:00",
    "number": "7400123456"
  }
}
noNumbers

Нет свободного номера

{
  "status": "error",
  "message": "NO_NUMBERS"
}

Примеры кода

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