метод REST scope: im

im.v2.File.download

Получить ссылку для скачивания файла

Кто может выполнять: пользователь с доступом к чату

Описание

Метод im.v2.File.download возвращает ссылку для скачивания файла из чата.

Параметры

dialogId string обязательный

ID диалога. Для групповых чатов — chat{chatId}, для личных — {userId}

fileId integer обязательный

ID файла на Диске. Можно получить из ответа метода im.v2.File.upload

Примеры запроса

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"dialogId":"chat5","fileId":138}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.v2.File.download

Ответ

HTTP-статус: 200

{
    "result": {
        "downloadUrl": "https://**put_your_bitrix24_address**/rest/download.json?token=im%7CaW..."
    },
    "time": {
        "start": 1728626400.123,
        "finish": 1728626400.234,
        "duration": 0.111,
        "processing": 0.045,
        "date_start": "2024-10-11T10:00:00+03:00",
        "date_finish": "2024-10-11T10:00:00+03:00"
    }
}

Возвращаемые данные

result object

Результат операции

result.downloadUrl string

Одноразовая ссылка для скачивания файла. Ссылка содержит авторизационный токен, повторное использование не гарантируется

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "FILE_NOT_FOUND",
    "error_description": "File not found"
}
Код Описание Значение
FILE_NOT_FOUND File not found Файл с таким идентификатором не найден
ACCESS_DENIED Access denied Нет доступа к чату

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.