Numbering API

Numbering API позволяет управлять номерами: покупать свободные номера, удалять их, настраивать переадресацию входящих вызовов, подключать услуги и т.д.

• GetList — получает характеристики номеров Exolve для покупки;
• GetFree — получает список свободных номеров для покупки по заданным параметрам;
• Lock — бронирует свободный номер для покупки;
• Unlock — отменяет бронирование номера;
• Buy — покупает бронированный номер;
• Delete — удаляет купленный номер;
• GetInfo — получает информацию о купленном номере;
• SetAmdState — подключает услугу детектирования автоответчиков на номере;
• SetCallForwarding — настраивает переадресацию входящих на номер вызовов;
• DeleteCallForwarding — отключает переадресацию входящих звонков на номер;
• GetAttributes — получает информацию о настройках переадресации и записи разговоров на номере.

Решения, где используется Numbering API

Интеграция виртуальной АТС с CRM

Кол-трекинг

Рекламные SMS-рассылки

Попробовать бесплатно

Метод GetList

Примените метод GetList для получения справочника по характеристикам номеров (тип, категория, регион, и проект). Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

POST: https://api.exolve.ru/number/reference/v1/GetList

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте пустой JSON в теле запроса.

Выходные параметры

NumberTypes

Categories

Regions

Возможные ошибки

Примеры

Входные параметры:

{}

Выходные параметры:

{
    "regions": [
        {
            "project_id": 10008,
            "region_id": 10257,
            "parent_region_id": 10084,
            "region_code": "SLH",
            "region_name": "Salekhard",
            "description": "Салехард"
        }
     ],
    "types": [
        {
            "type_id": 1104,
            "type_name": "DEF"
        }
     ],
    "categories": [
        {
            "category_id": 10003,
            "type_id": 1107,
            "type_name": "CEN",
            "category_name": "REGULAR"
        }
    ]
}

Метод GetFree

Примените метод GetFree для получения списка номеров, доступных для покупки

Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

POST: https://api.exolve.ru/number/v1/GetFree

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

Список типов номеров (type_id)

Список категорий номеров (category_id)

Список регионов (region_id)

Маска

Выходные параметры

NumberElement

NumberOptions

Примеры

Пример получения свободных номеров для региона «Москва», категории «Обычный», тип «Мобильный»:

Входные параметры:

{
    "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
            }
        }
    ]
}

Возможные ошибки

Метод Lock

Примените метод Lock для бронирования номера перед его покупкой.

Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

POST: https://api.exolve.ru/number/v1/Lock

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

Выходные параметры

Примеры

Входные параметры:

{
    "number_code": 74951340002,
    "seconds": 500
}

Выходные параметры:

{
    "Id": 1001884
}

Возможные ошибки

Метод Unlock

Примените метод Unlock для отмены бронирования номера.

Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

POST: https://api.exolve.ru/number/v1/Unlock

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

Выходные параметры

Пустой JSON с 200 OK статусом.

Примеры

Входные параметры:

{
    "number_code": 73412209107,
    "uid": 1000988
}

Выходные параметры:

{}

Возможные ошибки

Метод Lock

Примените метод Lock для бронирования номера перед его покупкой.

Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

POST: https://api.exolve.ru/number/v1/Lock

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

Выходные параметры

Примеры

Входные параметры:

{
    "number_code": 74951340002,
    "seconds": 500
}

Выходные параметры:

{
    "Id": 1001884
}

Возможные ошибки

Метод Buy

Примените метод Buy для покупки забронированного ранее номера.

Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

POST: https://api.exolve.ru/number/v1/Buy

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

На всех новых номерах автоматически подключена запись разговора. Отключить её можно на 31-й день с момента покупки в Личном кабинете или с помощью API-метода GetAttributes. Изменение срока хранения записей доступно в настройках приложения в Личном кабинете.

Речевая аналитика уже включает в себя текстовую расшифровку звонка, поэтому подключить одновременно и аналитику, и транскрибацию нельзя — выберите одну из услуг

Выходные параметры

Пустой JSON с 200 OK статусом.

Примеры

Входные параметры:

{
    "number_code": 74996480010,
    "reserve_uid": 1000993,
    "call_transcribation": true
}

Выходные параметры:

{}

Возможные ошибки

Метод Delete

Примените метод Delete для удаления купленного номера.

Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

POST: https://api.exolve.ru/number/v1/Delete

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

Выходные параметры

Пустой JSON с 200 OK статусом.

Примеры

Входные параметры:

{
    "number_code": 74951341115
}

Выходные параметры:

{}

Возможные ошибки

Метод GetInfo

Примените метод GetInfo для получения информации о купленном номере.

Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

POST: https://api.exolve.ru/number/customer/v1/GetInfo

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

Выходные параметры

NumberOptions

Примеры

Входные параметры:

{  
    "number_code": 79011550006
}

Выходные параметры:

{
    "number": {
        "number_name": "79991234455",
        "type_name": "DEF",
        "region_name": "Moscow",
        "application_name": "FLOWERSHOP24/7",
        "subscription_fee": 150,
        "install_fee": 590,
        "create_date": "2025-06-11T07:50:31.807946Z",
        "application_uuid": "c9c5031b-ad9b-4453-b6f8-bd5b14455790",
        "category_name": "REGULAR",
        "number_options": {
            "incoming_calls": true,
            "outgoing_calls": true,
            "incoming_sms": true,
            "outgoing_sms": true
        }
    }
}

Метод SetCallForwarding

Примените метод SetCallForwarding для настройки переадресации входящих вызовов на номере.

Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

POST: https://api.exolve.ru/number/v1/SetCallForwarding

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

CallForwardingType

CallForwardingData

CallForwardingSip

CallForwardingNumber

RedirectType

CallControl

Period

CallForwardingIpcr

CallForwardingStatic

CallForwardingStatics

RedirectTypeStatics

Выходные параметры

Пустой JSON с 200 OK статусом.

Примеры

Входные параметры для переадресации на внешний SIP-аккаунт (тип 1):

{
    "number_code": 74991112233,
    "call_forwarding_type": 1,
    "call_forwarding_sip": {
       "sip_uri": "testsip06844538@testsip.test.ru"
    }
}

Входные параметры для переадресации на номер или SIP ID (тип 2):

{
    "number_code": 74991112233,
    "call_forwarding_type": 2,
    "call_forwarding_number": {
       "redirect_type": 1,
       "call_control":[
           {
                "timeout": "16",
                "active": true,
                "period": "wd {Mon-Fri} hr {6am-14pm}",
                "period_description": "график будни",
                "name": "звонит клиент",
                "redirect_number": "74992223344" // или 883140XXXXXXXXX (SIP ID)
            }
       ],
        "event_url": "https://example.com/",
        "event_extended": true,
        "client_id": "test",
        "file_to_a": "12345",
        "file_to_b": "54321",
        "masking": true,
        "display_number": "74995556677"
    }
}

Входные параметры для динамической переадресации по API (на URL) (тип 3):

{
    "number_code": 74991112233,
    "call_forwarding_type": 3,
    "call_forwarding_ipcr": {
        "url": "https://example.com/",
        "reserve": "74993334455"
    }
}

Входные параметры для переадресации на SIP-транк (Static IP) (тип 4):

{
    "number_code": 74991112233,
    "call_forwarding_type": 4,
    "call_forwarding_static": {
       "static_ip": "127.0.0.1",
       "port": 10,
       "timeout": 30,
       "did": 111
    }
}

Входные параметры для переадресации на несколько SIP-транков (Static IP) последовательно (тип 6):

{
  "number_code": 74991112233,
  "call_forwarding_type": 6,
  "call_forwarding_ip_statics": {
    "redirect_type": 2,
    "ip_statics": [
      {
        "ip": "127.0.0.1",
        "port": 5060,
        "timeout": 60
      },
      {
        "ip": "111.112.113.114",
        "port": 5060,
        "timeout": 60
      }
    ]
  }
}

Входные параметры для переадресации на несколько SIP-транков (Static IP) с балансировкой трафика (тип 6):

{
  "number_code": 74991112233,
  "call_forwarding_type": 6,
  "call_forwarding_ip_statics": {
    "redirect_type": 3,
    "ip_statics": [
      {
        "ip": "127.0.0.1",
        "port": 5060,
        "timeout": 60,
        "percent": 40
      },
      {
        "ip": "111.112.113.114",
        "port": 5060,
        "timeout": 60,
        "percent": 60
      }
    ]
  }
}

Выходные параметры:

{}

Примечание к отправке уведомлений при входящем звонке

Вы можете настроить отправку уведомлений о ходе входящих звонков на URL-адрес вашего сервера двумя способами:

1. Установить URL для определённого номера, передав значение в поле event_url при выполнения метода SetCallForwarding.
2. Установить URL в настройках приложения в блоке «Уведомления о событиях» в Личном кабинете разработчика. Установленный URL применяется ко всем номерам приложения.

При отправке уведомлений о ходе входящего звонка платформа МТС Exolve сначала проверяет, указан ли URL индивидуально на номере вызова. Если URL не указан на номере, проверяет, указан ли в приложении. Подробнее:

1. Если URL указан и на номере, и в приложении, уведомления будут отправлены на URL из индивидуальных настроек номера.
2. Если URL указан на номере, но пуст в приложении, уведомления будут отправлены на URL из индивидуальных настроек номера.
3. Если URL не указан на номере, но указан в приложении, уведомления будут отправлены на URL из приложения

Возможные ошибки

Метод DeleteCallForwarding

Примените метод DeleteCallForwarding для удаления настроек переадресации входящих вызовов на номере.

Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

POST: https://api.exolve.ru/number/v1/DeleteCallForwarding

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

Выходные параметры

Пустой JSON с 200 OK статусом.

Примеры

Входные параметры:

{
    "number_code": 74951341115
}

Выходные параметры:

{}

Возможные ошибки

Метод GetAttributes

Примените метод GetAttributes для получения информации о настройках купленного номера (переадресация входящих звонков, запись разговоров).

Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

POST: https://api.exolve.ru/number/v1/GetAttributes

Авторизация

Передайте следующие заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

Выходные параметры

NumberAttributes

На всех новых номерах автоматически подключена запись разговора. Отключить её можно на 31-й день с момента покупки. Изменение срока хранения записей доступно в настройках приложения в Личном кабинете.

Речевая аналитика уже включает в себя текстовую расшифровку звонка, поэтому подключить одновременно и аналитику, и транскрибацию нельзя — выберите одну из услуг

ForwardingType

ForwardingNumber

CallControl

ForwardingIpcr

ForwardingSip

Примеры

Входные параметры:

{
    "number_code": 74996487174
}

Выходные параметры для номера с переадресацией на номер:

{
    "number_resource_id": "94004",
    "status_name": "Active",
    "attributes": {
        "call_record": false,
        "call_forwarding_type": 2,
        "call_forwarding_number": {
            "redirect_type": 1,
            "call_control":[
                {
                    "timeout": "16",
                    "active": true,
                    "name": "звонит клиент",
                    "redirect_number": "74996480184",
                    "dtmf": "8"
                }
            ],
           "event_url": "https://example.com/",
           "event_extended": true,
           "file_to_a": "12345",
           "file_to_b": "54321",
           "answer": true,
           "masking": true,
           "display_number": "74995557890"
        }
    }
}

Входные параметры для динамической переадресации по API:

{
    "number_resource_id": "51802",
    "status_name": "",
    "attributes": {
        "call_record": true,
        "call_forwarding_type": 3,
        "call_forwarding_ipcr": {
            "url": "http://example.com",
            "reserve": "74996482846"
        }
    }
}

Возможные ошибки

Решения, где используется Numbering API

Решения для IT-сервисов

Все решения для e‑commerce и ретейла

Решения для служб доставки

Попробовать бесплатно