Скачивание записей по прямой ссылке через токен без авторизации
Обзор
Позволяет скачивать файлы записей разговоров без авторизации при указании в URL идентификатора токена и значения 'reclink' из диалогу.
Запросы
HTTP verb | Endpoint | Описание |
---|---|---|
|
|
|
|
|
Скачивание файла записи
В качестве имени ресурса передается упакованное с помощью UrlEncode или base64 значение 'reclink'. Код записи (reclink) на скачивание может быть получен из событий callevents.records_moved или ccsevents.connection_set_record_info, либо взята из коллекции callcenter/connections/ArchiveConnections.
В URL участвует токен. Канал интеграции, чей токен используется, должен быть создан в конкретном домене, чьи записи предстоит скачивать по ссылке. Также он может быть создан в мастер-домене, если предстоит скачивать записи разных доменов. В этом случае к 'reclink' должен быть добавлен префикс "d:<DOMAIN>".
Канал интеграции должен иметь тип 'public', а также должен иметь права: самостоятельно либо через связанную учетную запись пользователя иметь роль 'admin' или 'callrec'.
Канал интеграции может быть ограничен обработкой запросов с конкретного ip4-адреса, маски адресов либо диапазона ip4-адресов.
В запрос может быть добавлен параметр mode=attachment, в этом случае файл возвращается с Content-Type=application и Content-Disposition: attachment. Иначе содержимое файла скачивается в соответствующем ему mimetype.
Запрос
GET /api/download/v1/a55c54b59ee6c8cfab2f83e33c2474d3/sk%3As3storage%3A2022-09-29%2F09%3A45%2Fmg11_64954320-1664444711490.mp3 HTTP/1.1
GET /api/download/v1/a55c54b59ee6c8cfab2f83e33c2474d3/c2s6dGVzdF9zM19yZWNvcmRzOjIwMjQtMDYtMDIvMTU6MTgvbWcxMl8yMTM4OTMxNTE5LTE3MTczNDE1MDgyNjgubXAz HTTP/1.1
GET /api/download/v1/a55c54b59ee6c8cfab2f83e33c2474d3?link=c2s6dGVzdF9zM19yZWNvcmRzOjIwMjQtMDYtMDIvMTU6MTgvbWcxMl8yMTM4OTMxNTE5LTE3MTczNDE1MDgyNjgubXAz&mode=attachment HTTP/1.1