GetInfo
Метод GetInfo
Примените этот метод для получения информации о звонках по уникальным идентификаторам вызовов. Для этого выполните POST запрос с входными параметрами к точке подключения, указанными ниже.
Точка подключения:
POST: https://api.exolve.ru/statistics/call-history/v1/GetInfo
Авторизация
Передайте следующие Заголовки HTTP для успешной авторизации.
Имя | Тип | Описание |
---|---|---|
Authorization | string | API-ключ приложения с Bearer перед ним. Пример: Bearer e***s0 , где e***s0 замените на API-ключ вашего приложения |
Входные параметры
Передайте следующие параметры в теле запроса в JSON формате. Параметры, отмеченные жирным шрифтом, являются обязательными.
Параметр | Тип | Описание |
---|---|---|
ids | uint64 | уникальные идентификаторы вызовов |
Выходные параметры
Параметр | Тип | Описание |
---|---|---|
call | CallElement | информация о звонках |
CallElement
Параметр | Тип | Описание |
---|---|---|
call_id | uint64 | уникальный идентификатор вызова. Одинаков во всех событиях и запросах в рамках одного вызова |
duration | uint32 | время разговора в секундах без учета проигрывания аудиосообщения абоненту B (принимает вызов) |
number_a | string | номер, с которого поступил вызов |
number_b | string | номер, на который поступил вызов |
extension | string | добавочный номер |
call_start | string | дата начала вызова со стороны абонента A (инициирует вызов) в формате RFC-3339 / ISO-8601 |
call_end | string | дата окончания соединения в формате RFC-3339 / ISO-8601 |
premedia_a_start | string | дата начала проигрывания аудиосообщения абоненту A (инициирует вызов) в формате RFC-3339 / ISO-8601 |
premedia_a_end | string | дата завершения проигрывания аудиосообщения абоненту A (инициирует вызов) в формате RFC-3339 / ISO-8601 |
record_call | boolean | True , если разговор записывался. False , если разговор не записывался |
redirect_type | uint32 | тип переадресации (1 - одиночная, 2- последовательная, 3- параллельная) |
application_uuid | string | уникальный идентификатор приложения, через которое совершался звонок |
application_name | string | наименование приложения, через которое совершался звонок |
setup_time | uint32 | время ожидания абонента А (инициирует вызов) до соединения с абонентом B (принимает вызов) или отбоя |
wait_time | uint32 | время ожидания абонента А до фактического ответа абонента B (принимает вызов) |
full_duration | uint32 | время разговора в секундах c учетом проигрывания аудиосообщения абоненту B (принимает вызов) |
call_sid | string | идентификатор звонка |
redirects | RedirectElement | информация о переадресации |
RedirectElement
Параметр | Тип | Описание |
---|---|---|
disconnect_cause | string | причина отбоя |
disconnect_side | string | инициатор отбоя |
number_c | string | номер для переадресации вызова |
init_redirect_time | string | дата начала вызова абонента C (принимает переадресованный вызов) |
answer_time | string | дата фактического ответа абонента C (принимает переадресованный вызов) в формате RFC-3339 / ISO-8601 |
premedia_b_start | string | дата начала проигрывания аудиосообщения абоненту B (принимает и переадресовывает вызов) в формате RFC-3339 / ISO-8601 |
premedia_b_end | string | дата завершения проигрывания аудиосообщения абоненту B (принимает и переадресовывает вызов) в формате RFC-3339 / ISO-8601 |
talk_time | string | начало разговорной фазы в формате RFC-3339 / ISO-8601 |
end_redirect_time | string | дата окончания вызова абонента C (принимает переадресованный вызов) в формате RFC-3339 / ISO-8601 |
reserve | boolean | признак переадресации на резервный номер. True , если вызов был отправлен на резервный номер. False , если вызов не отправлялся на резервный номер |
Возможные ошибки
Код | Статус | Пример сообщения | Описание |
---|---|---|---|
401 | Unauthorized | malformed token | не указан / не правильно указан API-ключ приложения |
400 | Bad Request | syntax error | синтаксическая ошибка в запросе |
Примеры
Входные параметры:
{
"ids": [
7013503421000974336
]
}
Выходные параметры:
{
"call": [
{
"call_id": "7013503421000974336",
"duration": 0,
"number_a": "7499000000",
"number_b": "79999999999",
"extension": "",
"call_start": "2022-12-27T13:58:40Z",
"call_end": "2022-12-27T13:58:40Z",
"record_call": false,
"redirect_type": 0,
"customer": "246",
"application_uuid": "d25b1d5a-6879-44a2-95fd-c9487bc4a1f4",
"setup_time": 16358,
"wait_time": 16358,
"full_duration": 30,
"call_sid": "cal120584e5-917d-4131-9baf-206b6987c93d",
"redirects": [
{
"disconnect_side": "",
"number_c": "79841234444",
"init_redirect_time": "2022-12-27T13:58:40Z",
"answer_time": "2022-12-27T13:58:40Z",
"end_redirect_time": "2022-12-27T13:58:40Z",
"reserve": false
}
]
}
]
}