Импортировать файлы

С помощью запроса вы можете импортировать в Tracker файлы, прикрепленные к задаче и комментариям под ней.

POST

https://api.tracker.yandex.net/v3/issues/<id_задачи>/attachments/_import?filename=<filename>&createdAt=<createdAt>&createdBy=<createdBy>

Важно

Перед выполнением запроса убедитесь, что у пользователя есть право на изменение задачи, к которой прикреплены файлы.

Формат запроса

Чтобы импортировать файл, используйте HTTP-запрос с методом POST. Файл передается в теле запроса с использованием multipart/form-data RFC-7578. Размер файла не должен превышать 1024 Мбит.

POST /v3/issues/<id_задачи>/attachments/_import?filename=<filename>&createdAt=<createdAt>&createdBy=<createdBy> 
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
Content-Type: multipart/form-data
<файл>
Заголовки

  • Host: адрес узла, предоставляющего API:

  • Authorization: токен для авторизации в одном из форматов:

    • OAuth <OAuth-токен> при авторизации по протоколу OAuth 2.0. Читать подробнее

    • Bearer <IAM-токен> при авторизации с помощью IAM-токена — если к Tracker привязана организация Yandex Cloud Organization. Читать подробнее

  • X-Org-ID или X-Cloud-Org-ID: идентификатор организации.

    • Используйте заголовок X-Org-ID, если к Tracker привязана организация Яндекс 360 для бизнеса.

    • Используйте заголовок X-Cloud-Org-ID, если к Tracker привязана организация Yandex Cloud Organization.

    Чтобы узнать идентификатор организации, перейдите на страницу Администрирование → Организации и скопируйте значение поля идентификатор.

  • Content-Type

    Формат тела запроса. Должен иметь значение multipart/form-data.

Ресурс
Параметр Описание Тип данных
<id_задачи> Ключ задачи, к которой будет прикреплен файл. Строка
<id_комментария> Идентификатор комментария, к которому будет прикреплен файл. Строка
Параметры запроса

Обязательные параметры

Параметр Описание Тип данных
filename Имя файла, максимальная длина — 255 символов. Строка
createdAt Дата и время прикрепления файла в формате YYYY-MM-DDThh:mm:ss.sss±hhmm. Вы можете указать любое значение в интервале времени от создания до последнего обновления задачи. Строка
createdBy Логин или идентификатор автора прикрепленного файла. Строка
Параметры тела запроса

Обязательные параметры

Параметр Описание Тип данных
file_data Загружаемый файл. Размер файла не должен превышать 1024 Мбит. Строка 
POST /v3/issues/<id_задачи>/comments/<id_комментария>/attachments/_import?filename={filename}&createdAt={createdAt}&createdBy={createdBy} 
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
Content-Type: multipart/form-data
<файл>
Заголовки

  • Host: адрес узла, предоставляющего API:

  • Authorization: токен для авторизации в одном из форматов:

    • OAuth <OAuth-токен> при авторизации по протоколу OAuth 2.0. Читать подробнее

    • Bearer <IAM-токен> при авторизации с помощью IAM-токена — если к Tracker привязана организация Yandex Cloud Organization. Читать подробнее

  • X-Org-ID или X-Cloud-Org-ID: идентификатор организации.

    • Используйте заголовок X-Org-ID, если к Tracker привязана организация Яндекс 360 для бизнеса.

    • Используйте заголовок X-Cloud-Org-ID, если к Tracker привязана организация Yandex Cloud Organization.

    Чтобы узнать идентификатор организации, перейдите на страницу Администрирование → Организации и скопируйте значение поля идентификатор.

  • Content-Type

    Формат тела запроса. Должен иметь значение multipart/form-data.

Ресурс
Параметр Описание Тип данных
<id_задачи> Ключ задачи, к которой будет прикреплен файл. Строка
<id_комментария> Идентификатор комментария, к которому будет прикреплен файл. Строка
Параметры запроса

Обязательные параметры

Параметр Описание Тип данных
filename Имя файла, максимальная длина — 255 символов. Строка
createdAt Дата и время прикрепления файла в формате YYYY-MM-DDThh:mm:ss.sss±hhmm. Вы можете указать любое значение в интервале времени от создания до последнего обновления задачи. Строка
createdBy Логин или идентификатор автора прикрепленного файла. Строка
Параметры тела запроса

Обязательные параметры

Параметр Описание Тип данных
<файл> Загружаемый файл. Размер файла не должен превышать 1024 Мбит. Строка

Формат ответа

В случае успешного выполнения запроса API возвращает ответ с кодом 200 OK.

Тело ответа содержит параметры прикрепленного файла в формате JSON:

{
  "self": "https://api.tracker.yandex.net/v3/issues/JUNE-2/attachments/123",
  "id" : "123",
  "name" : "pic.png",
  "content" : "api.tracker.yandex.net/v3/issues/JUNE-2/attachments/123/pic.png",
  "thumbnail" : "api.tracker.yandex.net/v3/issues/JUNE-2/thumbnails/123",
  "createdBy" : {
	"self": "https://api.tracker.yandex.net/v3/users/12********",
	"id" : "12********",
	"display" : "<отображаемое_имя_сотрудника>"
  },
  "createdAt" : "2017-06-11T05:16:01.339+0000",
  "mimetype" : "image/png",
  "size" : 5678,
  "metadata" : {
	"size" : "128x128"
  }
}
Параметры ответа
Параметр Описание Тип данных
self Адрес ресурса API, который соответствует прикрепленному файлу. Строка
id Уникальный идентификатор файла. Строка
name Имя файла. Строка
content Адрес ресурса для скачивания файла. Строка
thumbnail Адрес ресурса для скачивания миниатюры предпросмотра. Доступно только для графических файлов. Строка
createdBy Объект с информацией о пользователе, прикрепившем файл. JSON-объект
createdAt Дата и время загрузки файла в формате:
YYYY-MM-DDThh:mm:ss.sss±hhmm		 Строка
mimetype Тип файла, например:
  • text/plain — текстовый файл;
  • image/png — изображение в формате png.
 Строка
size Размер файла в байтах. Целое число
metadata Объект с метаданными файла. JSON-объект

Поля объекта createdBy

Параметр Описание Тип данных
self Адрес ресурса, соответствующего пользователю, загрузившему файл. Строка
id Логин пользователя. Строка
display Имя пользователя (как в интерфейсе). Строка

Поля объекта metadata

Параметр Описание Тип данных
size Размер изображения в пикселях. Строка

Если запрос не был успешно обработан, ответное сообщение содержит информацию о возникших ошибках:

400
Один или несколько параметров запроса имеют недопустимое значение.
403
У вас не хватает прав на выполнение этого действия. Наличие прав можно перепроверить в интерфейсе Tracker — для выполнения действия при помощи API и через интерфейс требуются одинаковые права.
404
Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.
413
Размер файла превышает 1024 Мбит.
422
Ошибка валидации JSON, запрос отклонен.
500
Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.
503
Сервис API временно недоступен.
Предыдущая
Импортировать задачу
Следующая
Импортировать комментарии