Арендовать номер
GEThttps://onlinesim.io/stubs/handler_api.php?action=getRentNumber
Арендует номер страны для приема SMS от любых отправителей. Цена аренды за период резервируется на балансе и списывается с первым SMS. Аренда заказывается без опции продления.
Ошибки в JSON ({"status":"error","message":…}):
NO_NUMBERS— сейчас нет свободного номера, или в стране нет аренды на этот периодNO_BALANCE— недостаточно денег на балансе
Ошибки текстом: BAD_COUNTRY (неизвестный или нечисловой country) и общие ошибки.
Безопасность
Параметры
query3
| Название | Тип | Описание |
|---|---|---|
action* | string | Имя метода: Перечисление: getRentNumber |
country | integer≥ 0 | ID страны из getCountries ( По умолчанию: 0Пример:16 |
rent_time | integer≥ 0 | Срок аренды в часах, округляется вверх до целых дней (2 → 1 день, 25 → 2 дня); По умолчанию: 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"
}Примеры кода
Генерация примеров...