GetFree
Метод GetFree
Примените метод GetFree для получения списка номеров, доступных для покупки
Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:
POST: https://api.exolve.ru/number/v1/GetFree
Авторизация
Передайте следующие Заголовки HTTP для успешной авторизации.
Имя | Тип | Описание |
---|---|---|
Authorization | string | API-ключ приложения с Bearer перед ним. Пример: Bearer e***s0 , где e***s0 замените на API-ключ вашего приложения |
Входные параметры
Передайте следующие параметры в теле запроса в JSON формате. Параметры, отмеченные жирным шрифтом, являются обязательными.
Параметр | Тип | Описание |
---|---|---|
type_id | uint32 | тип номера |
region_id | uint32 | регион номера |
category_id | uint32 | категория номера |
random | boolean | True вернёт номера в случайном порядке |
mask | string | маска |
limit | uint32 | лимит выводимых строк |
offset | uint32 | номер строки, с которой начинать выборку (начинается с 0) |
Список типов номеров (type_id)
Параметр | ID типа | Описание |
---|---|---|
DEF | 1104 | Мобильный |
ABC | 1105 | Городской |
KDU | 1106 | Федеральный 8-800 (использовать только с регионом Россия) |
Список категорий номеров (category_id)
Название | ID категории номера для типа мобильный | ID категории номера для типа городской | ID категории номера для типа 7-800 |
---|---|---|---|
Обычный | 10000 | 10001 | 10002 |
Бронзовый | 10010 | 10011 | 10012 |
Серебряный | 10020 | 10021 | 10022 |
Золотой | 10030 | 10031 | 10032 |
Платиновый | 10040 | 10041 | 10042 |
Эксклюзивный | 10050 | 10051 | 10052 |
Список регионов (region_id)
Название | ID типа номера |
---|---|
Россия | 10084 |
Магнитогорск | 10186 |
Пермь | 10181 |
Санкт-Петербург | 10182 |
Москва | 10230 |
Ростов-на-Дону | 10231 |
Омск | 10196 |
Новороссийск | 10221 |
Екатеринбург | 10190 |
Казань | 10195 |
Сочи | 10153 |
Самара | 10192 |
Краснодар | 10184 |
Нижний Новгород | 10189 |
Новосибирск | 10183 |
Красноярск | 10191 |
Челябинск | 10229 |
Тольятти | 10227 |
Воронеж | 10193 |
Маска
Символ | Назначение |
---|---|
Точка ( . ) / Подчёркивание ( _ ) | пропускает один символ параметра number_code в поиске |
Звёздочка ( * ) / Знак процента ( % ) | пропускает несколько символов параметра number_code в поиске |
Выходные параметры
Параметр | Тип | Описание |
---|---|---|
numbers | array NumberElement | список номеров с информацией по ним |
NumberElement
Параметр | Тип | Описание |
---|---|---|
type_name | string | наименование типа номера |
region_name | string | имя региона |
category_name | string | имя категории номера |
number_code | uint64 | код номера |
subscription_fee | float | ежемесячная абонентская плата |
install_fee | float | единоразовая плата за подключение |
number_options | array NumberOptions | возможности номера (звонки, SMS) |
NumberOptions
Параметр | Тип | Описание |
---|---|---|
incoming_calls | bool | входящие звонки, True — доступно, False — доступно |
outgoing_calls | bool | исходящие звонки, True — доступно, False — доступно |
incoming_sms | bool | входящие SMS, True — доступно, False — доступно |
outgoing_sms | bool | исходящие SMS, True — доступно, False — доступно |
Примеры
Пример получения свободных номеров для региона «Москва», категории «Обычный», тип «Мобильный»:
Входные параметры:
{
"type_id": 1104,
"region_id": 10230,
"category_id": 10000,
"random": true,
"limit": 1
}
Выходные параметры:
{
"numbers": [
{
"number_code": "79300655934",
"type_name": "DEF",
"region_name": "Moscow",
"category_name": "REGULAR",
"subscription_fee": 150,
"install_fee": 590,
"number_options": {
"incoming_calls": true,
"outgoing_calls": true,
"incoming_sms": true,
"outgoing_sms": true
}
}
]
}
Пример получения свободных номеров для региона «Санкт-Петербург», категории «Бронзовый», тип «Городской»:
Входные параметры:
{
"type_id": 1105,
"region_id": 10182,
"category_id": 10011,
"random": true,
"mask": "781221*",
"limit": 1
}
Выходные параметры:
{
"numbers": [
{
"number_code": "78122135222",
"type_name": "ABC",
"region_name": "St. Petersburg",
"category_name": "BRONZE",
"subscription_fee": 200,
"install_fee": 1000,
"number_options": {
"incoming_calls": true,
"outgoing_calls": true,
"incoming_sms": false,
"outgoing_sms": false
}
}
]
}
Пример получения свободных номеров для региона «Россия», категории «Серебряный», тип «Федеральный»:
Входные параметры:
{
"type_id": 1106,
"region_id": 10084,
"category_id": 10022,
"random": true,
"limit": 1
}
Входные параметры:
{
"numbers": [
{
"number_code": "78003333729",
"type_name": "KDU",
"region_name": "Russia",
"category_name": "SILVER",
"subscription_fee": 3500,
"install_fee": 50000,
"number_options": {
"incoming_calls": true,
"outgoing_calls": false,
"incoming_sms": false,
"outgoing_sms": false
}
}
]
}
Возможные ошибки
Код | Статус | Пример сообщения | Описание |
---|---|---|---|
400 | Bad Request | proto: syntax error (line 1:2): unexpected token | пустое значение в поле type_id |
400 | Bad Request | proto: syntax error (line 1:2): invalid value | значение в поле type_id невалидно |