GetInfo
Метод GetInfo
Примените этот метод для получения информации о записи разговора. Для этого выполните POST-запрос с входными параметрами к точке подключения, указанными ниже.
Точка подключения:
POST: https://api.exolve.ru/statistics/call-record/v1/GetInfo
Авторизация
Передайте следующие Заголовки HTTP для успешной авторизации.
Имя | Тип | Описание |
---|---|---|
Authorization | string | API-ключ приложения с Bearer перед ним. Пример: Bearer e***s0 , где e***s0 замените на API-ключ вашего приложения |
Входные параметры
Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.
Параметр | Тип | Описание |
---|---|---|
uids | uint64 | уникальные идентификаторы вызова |
Выходные параметры
Параметр | Тип | Описание |
---|---|---|
records | CallRecord | информация о записях разговоров |
CallRecord
Параметр | Тип | Описание |
---|---|---|
uid | uint64 | уникальный идентификатор вызова. Одинаков во всех событиях и запросах в рамках одного вызова |
customer | string | уникальный идентификатор личного кабинета |
record_path | string | прямой адрес расположения аудиофайла с записью разговора |
application_uuid | string | уникальный идентификатор приложения, которому принадлежит запись |
expires_at | string | дата в формате RFC-3339 / ISO-8601, до которой будет храниться запись разговора |
size | uint64 | размер файла, с разговором |
duration | uint32 | длительность разговора |
Возможные ошибки
Код | Статус | Пример сообщения | Описание |
---|---|---|---|
401 | Unauthorized | error getting JWT Token claims | неправильно указан токен (API-ключ приложения) |
400 | Bad Request | syntax error | синтаксическая ошибка |
Примеры
Входные параметры:
{
"uids": [
"7032315179928911872"
]
}
Выходные параметры:
{
"records": [
{
"uid": "7032315179928911872",
"customer": "9ff5d707-2614-427b-b973-ba6877a869c9",
"record_path": "https://api.exolve.ru/statistics/download/7032315179928911872",
"application_uuid": "9ff5d707-2614-427b-b973-ba6877a869c9",
"expires_at": "2023-03-19T00:00:00Z",
"size": "44844",
"duration": 1
}
]
}
Нецелевые сценарии
Код ошибки | Статус ошибки | Пример сообщения | Описание |
---|---|---|---|
401 | Unauthorized | unauthorized | невалидный API-key для авторизации |
400 | Bad Request | syntax error | синтаксическая ошибка в запросе |