SIP API

SIP API позволяет управлять SIP ID: создавать, изменять и удалять:

  • Create — создаёт SIP ID;
  • Delete — удаляет созданный SIP ID;
  • GetFees — получает абонентскую плату за использование SIP ID;
  • GetAttributes — получает настройки SIP ID;
  • GetSIPList — получает информацию обо всех SIP ID приложения по заданным параметрам;
  • SetDisplayNumber — устанавливает определяемый номера на SIP ID;
  • ChangePassword — меняет пароль от SIP ID.

Для звонков используются IP-адреса:

  • 80.75.130.100 — звонки с/на SIP ID МТС Exolve
  • 80.75.130.101 — звонки, переадресованные на внешнее SIP-соединение

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

Кол-трекинг

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

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

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

Метод Create

Примените метод Create для создания SIP ID — вы сможете использовать этот ресурс для исходящих и входящих звонков.

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

POST: https://api.exolve.ru/sip/v1/Create

Авторизация

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

ИмяТипОписание
AuthorizationstringAPI-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения

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

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

ПараметрТипОписание
sip_namestringназвание SIP ID
numberuint64определяемый номер
descriptionstringописание SIP ID
call_recordbooleanподключение записи разговоров. True — подключить запись разговоров, False — не подключать запись разговоров

Примечание
Чтобы подключить запись разговоров на SIP ID, предварительно подключите эту услугу в настройках приложения в Личном кабинете разработчика.

Определяемый номер используется для исходящих звонков при выходе в телефонную сеть общего пользования. В качестве такого номера можно назначить только один из номеров этого же приложения.


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

ПараметрТипОписание
sip_resource_iduint64идентификатор SIP ID
usernamestringюзернейм SIP ID

Примеры

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

{
    "sip_name": "Test",
    "number": 74991112233,
    "description": "Test SIP ID",
    "call_record": true
}

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

{
    "sip_resource_id": "1111",
    "username": "88314011122"
}

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

КодСтатусПример сообщенияОписание
401UnauthorizedUnauthorizedотсутствует/невалидный API-ключ
400Bad RequestError adding SIP: sip name is not unique on the applicationSIP ID с таким именем уже есть в приложении
400Bad RequestError adding SIP: not enough money on accountпопытка купить 4 SIP ID при нулевом балансе
400Bad RequestError adding SIP: customer is not activeаккаунт пользователя не активен
409ConflictError adding SIP: call record is disabled on the appуслуга записи звонков не включена в настройках приложения
500Internal Server ErrorApplication [app_name] does not own resource [number]указанный номер не принадлежит приложению
400Bad Requestinvalid value [value]в одном из полей невалидный формат
400Bad Requestvalue length must be between 3 and 40 runes, inclusiveполе sip_name должно содержать от 3 до 40 символов включительно

Метод Delete

Примените метод Delete для удаления SIP ID.

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

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

Авторизация

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

ИмяТипОписание
AuthorizationstringAPI-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения

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

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

ПараметрТипОписание
sip_resource_iduint64идентификатор SIP ID

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

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

Примеры

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

{
    "sip_resource_id": "111"
}

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

{}

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

КодСтатусПример сообщенияОписание
401UnauthorizedUnauthorizedотсутствует/не валидный API-ключ
400Bad RequestError deleting sip: SIP is missing in the applicationзаданный SIP ID не принадлежит приложению
400Bad RequestError adding SIP: customer is not activeаккаунт пользователя не активен
400Bad Requestinvalid value for uint64 typeзначение в поле sip_resource_id не валидно
400Bad RequestError adding SIP: customer is not activeаккаунт пользователя не активен

Метод GetFees

Примените метод GetFees для получения стоимости использования SIP ID — абонентской платы и стоимости подключения.

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

POST: https://api.exolve.ru/sip/v1/GetFees

Авторизация

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

ИмяТипОписание
AuthorizationstringAPI-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения

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

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

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

ПараметрТипОписание
install_feefloatстоимость подключения
subscription_feefloatежемесячная абонентская плата

Примеры

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

{}

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

{
    "install_fee": 0,
    "subscription_fee": 90
}

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

КодСтатусПример сообщенияОписание
401UnauthorizedUnauthorizedотсутствует/невалидный API-ключ
400Bad Requestinvalid value [value]невалидное значение в запросе
400Bad RequestError adding SIP: customer is not activeаккаунт пользователя неактивен

Метод GetAttributes

Примените метод GetAttributes для получения деталей (атрибутов) конкретного SIP ID.

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

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

Авторизация

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

ИмяТипОписание
AuthorizationstringAPI-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения

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

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

ПараметрТипОписание
sip_resource_iduint64идентификатор SIP ID

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

ПараметрТипОписание
application_uuidstringидентификатор приложения, в котором создан этот SIP ID
sip_resource_iduint64идентификатор SIP ID
sip_namestringназвание SIP ID
descriptionstringописание SIP ID
number_codeuint64юзернейм SIP ID в формате 88314XXXXXXXXXX
attributesSipAttributesатрибуты SIP ID
create_datestringдата создания SIP ID в формате RFC-3339 / ISO-8601
numbers_with_call_forwardingrepeated uint64номера, с которых переадресуются входящие звонки на этот SIP ID
statusstringстатус регистрации SIP ID на оборудовании с использованием логина и пароля

SipAttributes

ПараметрТипОписание
loginstingлогин SIP ID
passwordstringпароль SIP ID
install_feefloatстоимость подключения
subscription_feefloatабонентская плата
usernamestringюзернейм SIP ID
domainstringдомен для подключения
call_recordbooleanзапись звонков. True — подключено, False — отключено
clistringопределяемый номер для исходящих звонков в ТфОП

Примеры

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

{
    "sip_resource_id": "1234"
}

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

{
    "application_uuid": "c9c5031b-ad9b-4453-b6f8-bd1b14455790",
    "sip_resource_id": "1234",
    "sip_name": "SIP ID для исходящих звонков",
    "description": "",
    "number_code": "883140776926011",
    "attributes": {
        "login": "883140776926011",
        "password": "WbUMgSMihkr0",
        "subscription_fee": 95,
        "install_fee": 0,
        "username": "883140776926011",
        "domain": "sip.exolve.ru",
        "call_record": true,
        "cli": "79587723311"
    },
    "create_date": "2026-01-29T13:14:03.147699Z",
    "numbers_with_call_forwarding": [],
    "status": "registered"
}

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

КодСтатусПример сообщенияОписание
400Bad RequestError getting sip info: SIP is missing in the applicationискомый SIP ID не принадлежит этому приложению
400Bad Requestinvalid value for uint64 type [value]значение поля sip_resource_id невалидно
400Bad RequestError adding SIP: customer is not activeаккаунт пользователя неактивен
400Bad Request“error”: “invalid value *”невалидное значение поля
400Bad Request“error”: “unknown field *”невалидное значение поля
401Unauthorizedmalformed tokenотсутствует API-ключ
401UnauthorizedUnauthorizedневалидный API-ключ

Метод GetSIPList

Примените метод GetSIPList для получения информации о всех SIP ID приложения по заданным параметрам.

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

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

Авторизация

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

ИмяТипОписание
AuthorizationstringAPI-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения

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

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

ПараметрТипОписание
search_filter_by_namestringназвание SIP ID
limituint64лимит выводимых данных
offsetuint64номер строки, с которой начинать выборку (начинается с 0)
date_fromstringдата создания SIP ID в формате RFC-3339 / ISO-8601, от которой начинать выборку
date_tostringдата создания SIP ID в формате RFC-3339 / ISO-8601, до которой продолжать выборку
username_filterstringюзернейм SIP ID в формате 88314XXXXXXXXXX
clis_filterstringопределяемый номер, который используется в искомом SIP ID для исходящих звонков
order_byoneof OrderByтип сортировки

OrderBy

ПараметрТипОписание
order_by_nameenum OrderByNameсортировка по имени
order_by_dateenum OrderByDateсортировка по дате

OrderByName/OrderByDate

ПараметрТипОписание
1enumascending order (по возрастанию)
2enumdescending order (по убыванию) — по умолчанию для даты

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

ПараметрТипОписание
sipsSIPListElementсписок SIP ID и информация о них

Максимальное количество SIP ID в выходных параметрах: 256. Для получения информации о последующих SIP ID, воспользуйтесь смещением выбранного диапазона при помощи параметра offset. Пример: чтобы получить список SIP ID с 257 по 512, во входных параметрах укажите значение offset: 256


SIPListElement

ПараметрТипОписание
application_uuidstringидентификатор приложения, в котором создан SIP ID
sip_namestringназвание SIP ID
subscription_feefloatабонентская плата
install_feefloatстоимость подключения
sip_resource_iduint64идентификатор SIP ID
user_namestringюзернейм SIP ID
domainstringдомен для подключения
number_codestringюзернейм SIP ID
create_datestringдата создания SIP ID в формате RFC-3339 / ISO-8601
clistringопределяемый номер, используется для исходящих звонков с SIP ID

Примеры

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

{
    "limit": 10,
    "offset": 0,
    "date_from": "2022-12-19T12:35:56.122610Z",
    "date_to": "2025-05-21T12:35:56.122610Z",
    "clis_filter":
    [
     "79999999999",
     "79133333333"
    ],
    "order_by_name": 1
}

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

{
    "sips": [
        {
            "application_uuid": "178ec145-6898-4b06-a92a-75f63cb57046",
            "sip_name": "sip_name_1",
            "subscription_fee": 0,
            "install_fee": 0,
            "sip_resource_id": "1111",
            "user_name": "883140123456789",
            "domain": "sip.exolve.ru",
            "number_code": "883140123456789",
            "create_date": "2023-12-20T12:35:56.122610Z",
            "cli": "79991112233"
        },
        {
            "application_uuid": "178ec145-6898-4b06-a92a-75f63cb57046",
            "sip_name": "sip_name_2",
            "subscription_fee": 0,
            "install_fee": 0,
            "sip_resource_id": "2222",
            "user_name": "883140987654321",
            "domain": "sip.exolve.ru",
            "number_code": "883140987654321",
            "create_date": "2023-10-10T11:28:38.316920Z",
            "cli": "79994445566"
        }
    ]
}

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

КодСтатусПример сообщенияОписание
400Bad Request“unknown field ‘*’”в одном из полей невалидный формат данных
400Bad Request“unexpected token *”в одном из полей невалидный формат
400Bad Request“invalid value *”в одном из полей невалидный формат данных
400Bad Request“invalid value for uint64 field limit: *”значение поля limit невалидного формата
400Bad Request“invalid value for uint64 field offset: *”значение поля offset невалидного формата
400Bad Request“invalid value for string field searchFilterByName: *”значение поля searchFilterByName невалидного формата
400Bad Request“invalid value for string field ip: *”значение поля ip невалидного формата
400Bad Request“invalid value for enum field orderByName: *”в поле order_by_name должно быть одно из определённых значений
400Bad Request“invalid value for enum field orderByDate: *”в поле order_by_date должно быть одно из определённых значений
401Unauthorizedmalformed tokenотсутствует API-ключ
401Unauthorizedunauthorizedневалидный API-ключ
500Internal Server Error“Error getting SIP list: *”количество SIP ID в выходных параметрах превышает максимальный лимит (256)

Метод SetDisplayNumber

Примените метод SetDisplayNumber для установки определяемого номера на SIP ID — это нужно для исходящих звонков на номера телефонной сети общего пользования (ТфОП).

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

POST: https://api.exolve.ru/sip/v1/SetDisplayNumber

Авторизация

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

ИмяТипОписание
AuthorizationstringAPI-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения

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

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

ПараметрТипОписание
sip_resource_iduint64идентификатор SIP ID
numberuint64определяемый номер для исходящих звонков в ТфОП

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

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

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

КодСтатусПример сообщенияОписание
401UnauthorizedUnauthorizedотсутствует/невалидный API-ключ
400Bad RequestError set sip display number: incorrect number formatнеправильный формат номера в поле number
400Bad RequestError set sip display number: number is missing in the applicationуказанный номер не принадлежит приложению
400Bad RequestError getting sip info: SIP is missing in the applicationзаданный SIP ID не принадлежит приложению
400Bad RequestError adding SIP: customer is not activeаккаунт пользователя неактивен

Примеры

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

{
    "sip_resource_id": 1111,
    "number": 79991112233
}

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

{}

Метод ChangePassword

Примените этот метод для смены пароля от SIP ID. Для этого выполните POST запрос с входными параметрами к точке подключения, указанными ниже.

Точка подключения:

POST: https://api.exolve.ru/sip/v1/ChangePassword

Авторизация

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

ИмяТипОписание
AuthorizationstringAPI-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения

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

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

ПараметрТипОписание
sip_resource_iduint64уникальный идентификатор ресурса SIP ID

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

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

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

КодСтатусПример сообщенияОписание
401UnauthorizedUnauthorizedотсутствует/не валидный API-ключ
400Bad RequestError getting sip info: SIP is missing in the applicationзаданный SIP ID не принадлежит приложению
400Bad RequestError adding SIP: customer is not activeаккаунт пользователя не активен
400Bad Requestinvalid value [value]значение в поле sip_resource_id не валидно

Примеры

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

{
    "sip_resource_id": 1111,
}

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

{}