Скачивание файла

Отдаёт сам файл, а не ссылку на него, и подходит для любого вложения, которое видно токену. Для вложений без прямой ссылки на хранилище это единственный способ: в поле url у них стоит адрес этого метода, и открыть его можно только с токеном. Так отдаются зашифрованные файлы и отправленные из безопасного контура пространства — обе настройки описаны в разделе Шифрование и безопасный контур.

Отказ приходит 403 с кодом confidential_download_denied. Сверяется при этом адрес, с которого пришёл запрос, то есть адрес вашего сервера, а не сотрудника, чьим токеном вы пользуетесь: для серверной интеграции это самая частая причина отказа. В пространстве с безопасным контуром файлы проверяет антивирус, и на файл, в котором найден вирус, метод отвечает тем же 403 с любого адреса.

Ответ — тело файла и заголовок Content-Disposition с его именем, а не JSON. Зашифрованный файл расшифровывается на лету и приходит вложением целиком: target для него не действует. Если расшифровать не удалось, ответ — 400 с кодом decryption_failed.

Вложение сообщения доступно тому, кто видит само сообщение, а вложение черновика — только его автору.

Запрос HEAD на тот же адрес проходит те же проверки и отвечает только заголовками: Content-Length — размер файла или варианта из target, Content-Disposition — его имя. У зашифрованного файла Content-Length нет. Отказы приходят с теми же статусами, но без тела, а на отсутствующий файл или вариант — 404.