Скачать файл заявки

GET /tickets/:ticket_id/files/:hash

---

URL

https://домен_системы/api/v2/tickets/123/files/3760ca48e1d2ba5e06ded4162cbe1d5ab6d6f44f

---

Параметры

PATH-параметры

Параметр	Тип	Обязательный	Описание
ticket_id	число	Да	Технический ID заявки, к которой приложен файл
hash	строка	Да	Идентификатор файла из поля hash метода GET /tickets/:ticket_id/files/

---

Ответы

При успешном запросе в теле ответа приходит сам файл. Имя файла передаётся в заголовке Content-Disposition в кодировке UTF-8.

Заголовки ответа

Content-Type: <определяется по содержимому файла>
Content-Length: <размер в байтах>
Content-Disposition: attachment; filename*=UTF-8''<имя файла>
Cache-Control: private, no-store
X-Content-Type-Options: nosniff

Примеры ошибок

{
    "errors": [
        {
            "code": "e-401",
            "title": "Authorization error",
            "details": "Username or api key is incorrect"
        }
    ]
}

{
    "errors": [
        {
            "code": "e-404",
            "title": "Not found",
            "details": "File with hash {deadbeefdeadbeefdeadbeefdeadbeefdeadbeef} does not exist" // файла не существует, он недоступен пользователю или приложен к другой заявке
        }
    ]
}

{
    "errors": [
        {
            "code": "e-404",
            "title": "Not found",
            "details": "Ticket with id {99999999} does not exist" // заявки не существует или она недоступна пользователю
        }
    ]
}

к сведению

Поле url в массивах files[] ведёт на публичную ссылку вида /{lang}/file/download/{hash}. Если в Управление → Безопасность/Авторизация → Файлы включена настройка «Доступ к файлам для скачивания только после авторизации», такая ссылка работает только по сессии браузера и на запрос с внешнего сервера вернёт 404.

Для серверных интеграций используйте этот метод.