Как правильно спроектировать эндпоинт для скачивания файла (Download)?

Скачивание файлов в REST API имеет свои нюансы:

1. Метод: GET /files/{file_id}/download.
2. Заголовки ответа: Сервер должен вернуть Content-Disposition: attachment; filename="report.pdf". Это заставит браузер показать окно "Сохранить как...", а не пытаться открыть файл в новой вкладке.
3. Content-Type: Указать правильный MIME-тип (например, application/pdf или application/octet-stream для неизвестных бинарников).
4. Безопасность: Если файл приватный, передавать JWT-токен в заголовке Authorization (а не в Query-параметрах URL, чтобы токен не утек в логи прокси-серверов).