Управление заголовками файлов

К ссылкам на файлы выгрузок в хранилище Q-Parser можно добавить GET-параметр headers и таким образом управлять HTTP-заголовками ответа сервера при скачивании файла.

Это полезно, если ваш импортёр или сторонний сервис ожидает определённый Content-Type или другие заголовки ответа.

Как это работает?

Возьмите обычную ссылку на файл выгрузки (в том числе постоянную ссылку из автовыгрузки) и добавьте к ней параметр headers в формате:

?headers[имя-заголовка]=значение

Имя заголовка указывается в нижнем регистре. Можно задать сразу несколько заголовков.

Примеры

Указать тип содержимого как XML:

https://s3.q-parser.ru/.../file.xml?headers[content-type]=text/xml

Несколько заголовков одновременно:

https://s3.q-parser.ru/.../file.xml?headers[content-type]=application/xml&headers[content-disposition]=inline

На что обратить внимание

• Параметр работает только для файлов в хранилище Q-Parser. Для выгрузки на собственный FTP или S3 заголовки задаются на стороне вашего хранилища.
• Параметр можно добавлять как к разовым ссылкам после ручной выгрузки, так и к постоянным ссылкам автовыгрузки — при обновлении файла ссылка с параметрами продолжит работать.
• Если в ссылке уже есть другие GET-параметры, добавляйте headers через &, а не через ?.
• Значения параметров лучше URL-кодировать (encode), особенно если в них есть пробелы, спецсимволы или кириллица. Например, text/xml можно оставить как есть, а attachment; filename="каталог.xml" лучше передать как attachment%3B%20filename%3D%22%D0%BA%D0%B0%D1%82%D0%B0%D0%BB%D0%BE%D0%B3.xml%22.