Получить список файлов заявки

GET /tickets/:ticket_id/files/

---

URL

https://домен_системы/api/v2/tickets/123/files/?page=1

---

Параметры

PATH-параметры

Параметр	Тип	Обязательный	Описание
ticket_id	число	Да	Технический ID заявки, вложения которой будут показаны

Query-параметры

Параметр	Тип	Обязательный	Описание
page	число	Нет	Номер страницы (на странице показывается 30 файлов)

---

Ответы

Пример ответа

{
    "data": [
        {
            "name": "screenshot.png",
            "hash": "898465fffbfed3ba69a3929a5d44f98db249101d", // идентификатор файла для скачивания
            "url": "https://домен_системы/ru/file/download/898465fffbfed3ba69a3929a5d44f98db249101d",
            "data_type": "png",
            "post_id": 89937, // ID ответа, к которому приложен файл
            "comment_id": 0
        },
        {
            "name": "act.pdf",
            "hash": "3760ca48e1d2ba5e06ded4162cbe1d5ab6d6f44f",
            "url": "https://домен_системы/ru/file/download/3760ca48e1d2ba5e06ded4162cbe1d5ab6d6f44f",
            "data_type": "pdf",
            "post_id": 89938,
            "comment_id": 0
        },
        {
            "name": "internal.txt",
            "hash": "76b34ae5769b255e69a7678bb42daac89df4fc03",
            "url": "https://домен_системы/ru/file/download/76b34ae5769b255e69a7678bb42daac89df4fc03",
            "data_type": "txt",
            "post_id": 0,
            "comment_id": 14411 // ID комментария, к которому приложен файл
        }
    ],
    "pagination": {
        "total": 3,
        "per_page": 30,
        "current_page": 1,
        "total_pages": 1
    }
}

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

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

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

к сведению

Метод возвращает вложения из описания заявки, из ответов и из комментариев — с учётом прав пользователя, чьим API-ключом выполнена авторизация. Файлы комментариев, недоступных пользователю, в список не попадают.

Значение hash используется для скачивания файла методом GET /tickets/:ticket_id/files/:hash.