Метод GetTranscribation
Примените этот метод для получения текстовой расшифровки звонка. Для этого выполните POST-запрос с входными параметрами к точке подключения, указанными ниже.
Точка подключения:
POST: https://api.exolve.ru/statistics/call-record/v1/GetTranscribation
Авторизация
Передайте следующие Заголовки HTTP для успешной авторизации.
| Имя | Тип | Описание |
|---|---|---|
| Authorization | string | API-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения |
Входные параметры
Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.
| Параметр | Тип | Описание |
|---|---|---|
| uid | uint64 | идентификатор звонка |
Выходные параметры
| Параметр | Тип | Описание |
|---|---|---|
| url | string | URL-адрес для отправки события о готовности текстовой расшифровки звонка |
| uid | uint64 | идентификатор вызова |
| application_uuid | string | идентификатор приложения, с номера которого был совершён звонок |
| date_time | string | дата звонка в формате RFC-3339 / ISO-8601 |
| number_a | string | номер звонящего абонента |
| number_b | string | номер принимающего вызов абонента |
| redirect_number | string | номер для переадресации |
| duration | uint32 | длительность разговора |
| chunks | Chunks | текстовая расшифровка, разбитая на реплики участников звонка |
Chunks
| Параметр | Тип | Описание |
|---|---|---|
| channel_tag | uint64 | канал связи (1 — звонящий абонент, 2 — отвечающий абонент) |
| text | string | текст реплики |
| start_time | uint64 | время начала фразы в секундах |
| end_time | uint64 | время конца фразы в секундах |
Возможные ошибки
| Код | Статус | Пример сообщения | Описание |
|---|---|---|---|
| 400 | Bad Request | invalid value [value] | в поле uid невалидный формат |
| 401 | Bad Request | error while trying to get token from header | нет заголовка авторизации |
| 401 | Bad Request | failed to parse token | невалидный API-ключ |
| 404 | Bad Request | not found transcribation with uid | нет текстовой расшифровки по этому идентификатору звонка |
| 404 | Not Found | invalid uid or application uuid | неверный идентификатор звонка |
Примеры
Входные параметры:
{
"uid": 7143406780209569792
}
Выходные параметры:
{
"transcribation": [
{
"url": "",
"uid": "7143406780209569792",
"application_uuid": "178ec145-6898-4b06-a92a-75f63cb57046",
"date_time": "2023-12-21T01:09:10Z",
"number_b": "74991112233",
"calling_number": "79994445566",
"number_a": "79997778899",
"duration": 39,
"call_start": "2023-12-13T14:26:44Z",
"call_end": "2023-12-13T14:30:44Z",
"chunks": {
"channel_tag": "1",
"text": "привет",
"start_time": {
"seconds":0
},
"end_time": {
"seconds":0
}
}
}
]
}