--- metadata: - name: generator content: Diplodoc Platform v5.57.3 - property: og:type content: article - property: article:section content: Справочник API - property: og:title content: Импортировать задачу - property: article:tag content: Техническая инструкция alternate: - https://yandex.ru/support/tracker/en/api/import/import-ticket.md - https://yandex.ru/support/tracker/ru/api/import/import-ticket.md - href: ru/api/import/import-ticket.md type: text/markdown title: Markdown version - href: ../../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/ru/llms.txt # Импортировать задачу С помощью запроса вы можете импортировать в Трекер задачи из других систем управления проектами.

POST

https://api.tracker.yandex.net/v3/issues/_import
{% note warning "" %} Запрос может быть выполнен только от имени [администратора](https://yandex.ru/support/tracker/role-model.html). {% endnote %} ## Формат запроса {#query} Чтобы импортировать задачу, используйте HTTP-запрос с методом `POST`. Параметры задачи передаются в теле запроса в формате JSON: ```json translate=no POST /v3/issues/_import Host: api.tracker.yandex.net Authorization: OAuth Content-Type: application/json X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации> { "queue": "TEST", "summary": "Test", "createdAt": "2017-08-29T12:34:41.740+0000", "createdBy": 11******** } ``` При необходимости вы можете расширить список полей, доступных для импорта. Для этого [создайте](https://yandex.ru/support/tracker/user/create-param.html) в Трекере дополнительные поля и укажите их в теле запроса в формате: ``` "<имя_поля>": "<значение_поля>" ``` {% cut "Заголовки" %} * `Host`: адрес узла, предоставляющего API. * `Authorization`: токен для авторизации в одном из форматов: - `OAuth ` при авторизации по протоколу OAuth 2.0. [Читать подробнее](https://yandex.ru/support/tracker/ru/api/access.md#about_OAuth) - `Bearer ` при авторизации с помощью IAM-токена — если к Трекеру привязана организация Yandex Identity Hub. [Читать подробнее](https://yandex.ru/support/tracker/ru/api/access.md#iam-token) * `Content-Type`: формат тела запроса. Должен иметь значение `application/json`. * `X-Org-ID` или `X-Cloud-Org-ID`: идентификатор организации. - если к Трекеру привязана организация Яндекс 360 для бизнеса, используйте заголовок `X-Org-ID`, - если к Трекеру привязана организация Yandex Identity Hub, используйте заголовок `X-Cloud-Org-ID`. Чтобы узнать идентификатор организации, перейдите на страницу **Администрирование** → [**Организации**](https://tracker.yandex.ru/admin/orgs) и скопируйте значение поля **идентификатор**. {% endcut %} {% cut "Параметры тела запроса" %} **Обязательные параметры** Параметр | Описание | Тип данных -------- | -------- | ---------- queue | Ключ очереди. | Строка summary | Название задачи, не более 255 символов. | Строка createdAt | Дата и время создания задачи в формате `YYYY-MM-DDThh:mm:ss.sss±hhmm`. Не может быть позже текущего времени. | Строка createdBy | Логин или идентификатор автора задачи. |
  • Строка для логина
  • Число для идентификатора
**Дополнительные параметры** {% note info "" %} В таблице перечислены основные параметры запроса. Полный список параметров и их описание см. на странице [Параметры запроса](https://yandex.ru/support/tracker/ru/api/issues/request-fields.md). Также вы можете использовать глобальные пользовательские поля и локальные поля очередей. {% endnote %} #| || **Параметр** | **Описание** | **Тип данных** || || key | Ключ задачи. Ключ должен относиться к очереди, в которую импортируется задача. Если параметр не указан, задаче будет автоматически присвоен ключ. {% note warning "" %} В Трекер нумерация ключей задач возрастающая. При импорте с указанием номера рекомендуем выбирать минимальное свободное значение — при создании задач он всегда назначается на единицу больше максимального существующего. Например, если импортировать в пустую очередь задачу с номером `KEY-100`, то следующие задачи будут иметь номера `KEY-101`, `KEY-102` и так далее, а значения от `KEY-1` до `KEY-99` останутся незанятыми. {% endnote %} | Строка || || updatedAt | Дата и время последнего изменения задачи в формате `YYYY-MM-DDThh:mm:ss.sss±hhmm`. Вы можете указать любое значение в интервале времени от создания задачи до текущего момента. Параметр указывается только вместе с параметром `updatedBy`. | Строка || || updatedBy | Логин или идентификатор пользователя, который редактировал задачу последним. Параметр указывается только вместе с параметром `updatedAt`. |
  • Строка для логина
  • Число для идентификатора
|| || resolvedAt | Дата и время проставления резолюции в формате `YYYY-MM-DDThh:mm:ss.sss±hhmm`. Вы можете указать любое значение в интервале времени от создания до последнего изменения задачи. Параметр указывается только вместе с параметрами `resolution` и `resolvedBy`. | Строка || || resolvedBy | Логин или идентификатор пользователя, который проставил резолюцию. Параметр указывается только вместе с параметрами `resolution` и `resolvedAt`. |
  • Строка для логина
  • Число для идентификатора
|| || status | Идентификатор статуса задачи. Статус должен присутствовать в рабочем процессе очереди для выбранного типа задачи. Если статус не указан, используется начальный статус рабочего процесса. | Число || || deadline | Дедлайн в формате `YYYY-MM-DD`. | Строка || || resolution | Идентификатор резолюции задачи. Параметр указывается только вместе с параметрами `resolvedBy` и `resolvedAt`. | Число || || type | Идентификатор типа задачи. Тип задачи должен присутствовать в очереди. Если тип не указан, то используется тип задачи, который выбран для очереди по умолчанию. | Число || || description | Описание задачи, не более 512000 символов. | Строка || || start | Дата начала в формате `YYYY-MM-DD`. | Строка || || end | Дата окончания в формате `YYYY-MM-DD`. | Строка || || assignee | Логин или идентификатор исполнителя. |
  • Строка для логина
  • Число для идентификатора
|| || priority | Идентификатор приоритета. Если приоритет не указан, то используется приоритет, который выбран для очереди по умолчанию. | Число || || affectedVersions | Идентификаторы версий, перечисленные в поле **Найдено в версиях**. Версии должны существовать в очереди. | JSON-массив || || fixVersions | Идентификаторы версий, перечисленные в поле **Исправить в версиях**. Версии должны существовать в очереди. | JSON-массив || || components | Идентификаторы компонентов, к которым относится задача. Компоненты должны существовать в очереди. | JSON-массив || || tags | Массив тегов задачи. | JSON-массив || || sprint | Идентификаторы спринтов, к которым относится задача. | JSON-массив || || followers | Массив с идентификаторами или логинами наблюдателей задачи. | JSON-массив || || access | Массив с идентификаторами или логинами пользователей, перечисленных в поле **Доступ**. | JSON-массив || || unique | Уникальный идентификатор задачи. Вы можете задать любой идентификатор. | Строка || || followingMaillists | Идентификаторы рассылок — команд и отделов, подписанных на задачу. | JSON-массив || || originalEstimation | Значение параметра "Первоначальная оценка" в миллисекундах. | Число || || estimation | Значение параметра "Оценка" в миллисекундах. | Число || || spent | Значение параметра "Затрачено времени" в миллисекундах. | Число || || storyPoints | Значение параметра Story Points. | Число с плавающей точкой || || votedBy | Массив с идентификаторами или логинами пользователей, которые проголосовали за задачу. | JSON-массив || || favoritedBy | Массив с идентификаторами или логинами пользователей, которые добавили задачу в избранное. | JSON-массив || |# {% endcut %} > Пример: Импортировать задачу. > > - Используется HTTP-метод `POST`. > - В ответе включено отображение всех дополнительных полей. >```json translate=no >POST /v3/issues/_import >Host: api.tracker.yandex.net >Authorization: OAuth y0__xAbc****** >Content-Type: application/json >X-Org-ID: 1234****** > >{ > "queue": "TEST", > "summary": "Test", > "key": "TEST-1", > "createdAt": "2017-08-29T12:34:41.740+0000", > "createdBy": 11********, > "updatedAt": "2017-09-09T11:24:31.140+0000", > "updatedBy": 11********, > "resolvedAt": "2017-09-08T09:33:42.250+0000", > "resolvedBy": 11********, > "status": 17, > "deadline": "2017-09-07", > "resolution": 1, > "type": 2, > "description": "Test", > "start": "2017-09-04", > "end": "2017-09-07", > "assignee": 11********, > "priority": 3, > "affectedVersions": [1, 2, 3], > "fixVersions": [4, 5, 6], > "components": [7, 8, 9], > "tags": ["test", "tag"], > "sprint": [1, 2, 3], > "followers": [11********, 22********], > "access": [11********, 22********], > "unique": "issue_51827865998247********", > "followingMaillists": ["test@test.yaconnect.com", "mail@test.yaconnect.com"], > "originalEstimation": 3600000, > "estimation": 3600000, > "spent": 3600000, > "storyPoints": 1.0, > "votedBy": [11********, 22********], > "favoritedBy": [11********, 22********] >} >``` ## Формат ответа {#answer} {% list tabs %} - Запрос выполнен успешно В случае успешного выполнения запроса API возвращает ответ с кодом `200 OK`. Тело ответа содержит параметры прикрепленного файла в формате JSON: ```json translate=no { "self": "https://api.tracker.yandex.net/v3/issues/TEST-1", "id": "141b2ef1e4b036e9********", "key": "TEST-1", "version": 1, "summary": "Test", "originalEstimation": "P1H", "estimation": "P1H", "spent": "P1H", "updatedBy": { "self": "https://api.tracker.yandex.net/v3/users/11********", "id": "11********", "display": "Имя Фамилия" }, "resolvedAt": "2017-09-08T09:33:42.250+0000", "start": "2017-09-04", "resolvedBy": { "self": "https://api.tracker.yandex.net/v3/users/11********", "id": "11********", "display": "Имя Фамилия" }, "description": "Test", "followingMaillists": [ { "self": "https://api.tracker.yandex.net/v3/maillists/test@test.yaconnect.com", "id": "test@test.yaconnect.com", "display": "test" }, { "self": "https://api.tracker.yandex.net/v3/maillists/mail@test.yaconnect.com", "id": "mail@test.yaconnect.com", "display": "mail" } ], "fixVersions": [ { "self":"https://api.tracker.yandex.net/v3/versions/4", "id":"4", "display":"Version 4" }, { "self":"https://api.tracker.yandex.net/v3/versions/5", "id":"5", "display":"Version 5" }, { "self":"https://api.tracker.yandex.net/v3/versions/6", "id":"6", "display":"Version 6" } ], "type": { "self": "https://api.tracker.yandex.net/v3/issuetypes/2", "id": "2", "key": "task", "display": "Task" }, "priority": { "self":"https://api.tracker.yandex.net/v3/priorities/3", "id":"3", "key":"normal", "display":"Normal" }, "resolution": { "self":"https://api.tracker.yandex.net/v3/resolutions/1", "id":"1", "key":"fixed", "display":"Fixed" }, "createdAt": "2017-08-29T12:34:41.740+0000", "followers": [ { "self": "https://api.tracker.yandex.net/v3/users/11********", "id": "11********", "display": "Имя Фамилия" }, { "self": "https://api.tracker.yandex.net/v3/users/12********", "id": "12********", "display": "Имя Фамилия" } ], "assignee": { "self": "https://api.tracker.yandex.net/v3/users/11********", "id": "11********", "display": "Имя Фамилия" }, "createdBy": { "self": "https://api.tracker.yandex.net/v3/users/11********", "id": "11********", "display": "Имя Фамилия" }, "commentWithoutExternalMessageCount": 0, "votes": 0, "affectedVersions": [ { "self":"https://api.tracker.yandex.net/v3/versions/1", "id":"1", "display":"Version 1" }, { "self":"https://api.tracker.yandex.net/v3/versions/2", "id":"2", "display":"Version 2" }, { "self":"https://api.tracker.yandex.net/v3/versions/3", "id":"3", "display":"Version 3" } ], "commentWithExternalMessageCount": 0, "end": "2017-09-07", "deadline": "2018-05-28", "queue": { "self": "https://api.tracker.yandex.net/v3/queues/TEST", "id": "1", "key": "TEST", "display": "Test" }, "updatedAt": "2017-09-09T11:24:31.140+0000", "storyPoints": 1.0, "status": { "self": "https://api.tracker.yandex.net/v3/statuses/17", "id": "17", "key": "closed", "display": "Closed" }, "components":[ { "self":"https://api.tracker.yandex.net/v3/components/7", "id":"7", "display":"Component 7" }, { "self":"https://api.tracker.yandex.net/v3/components/8", "id":"8", "display":"Component 8" }, { "self":"https://api.tracker.yandex.net/v3/components/9", "id":"9", "display":"Component 9" } ], "access": [ { "self": "https://api.tracker.yandex.net/v3/users/11********", "id": "11********", "display": "Имя Фамилия" }, { "self": "https://api.tracker.yandex.net/v3/users/12********", "id": "12********", "display": "Имя Фамилия" } ], "unique": "issue_51827865998247********", "favorite": false } ``` {% cut "Параметры ответа" %} Параметр | Описание | Тип данных ---------| ---------| ---------- self | Адрес ресурса API, который содержит информацию о задаче. | Строка id | Адрес ресурса API, который содержит информацию о задаче. | Строка key | Ключ задачи. | Строка version | Версия задачи. Каждое изменение параметров задачи увеличивает номер версии. | Число summary | Название задачи. | Строка originalEstimation | Значение параметра "Первоначальная оценка". | Строка estimation | Значение параметра "Оценка". | Строка spent | Значение параметра "Затрачено времени". | Строка [updatedBy](#updatedBy) | Объект с информацией о пользователе, который изменял задачу последним. | Объект resolvedAt | Дата и время проставления резолюции. | Строка start | Дата начала работы над задачей. | Строка [resolvedBy](#resolvedBy) | Объект с информацией о пользователе, который проставил резолюцию. | Объект description | Описание задачи. | Строка [followingMaillists](#followingMaillists) | Массив объектов с информацией о рассылках — командах и отделах, подписанных на задачу. | Массив объектов [fixVersions](#fixVersions) | Версии, перечисленные в поле "Исправить в версиях". | JSON-массив [type](#type) | Тип задачи. | JSON-массив [priority](#priority) | Объект с информацией о приоритете. | Объект [resolution](#resolution) | Объект с информацией о резолюции. | Объект createdAt | Дата и время создания задачи. | Строка [followers](#followers) | Массив объектов с информацией о наблюдателях задачи. | Массив объектов [assignee](#assignee) | Массив объектов с информацией об исполнителе. | Массив объектов [createdBy](#createdBy) | Массив объектов с информацией об авторе задачи. | Массив объектов [affectedVersions](#affectedVersions) | Версии, перечисленные в поле "Обнаружено в версиях". | JSON-массив [queue](#queue) | Объект с информацией об очереди, к которой относится задача. | Объект [status](#status) | Объект с информацией о статусе задачи. | Объект [components](#components) | Массив объектов с информацией о компонентах, к которым относится задача. | Массив объектов [access](#access) | Массив объектов с информацией о пользователях, перечисленных в поле Доступ. | Массив объектов commentWithoutExternalMessageCount | Число комментариев к задаче. | Число votes | Число голосов, отданых за задачу. | Число commentWithExternalMessageCount | Число писем отправленных со страницы задачи. | Число end | Дата завершения работы над задачей. | Строка deadline | Дедлайн | Строка updatedAt | Дата и время последнего изменения задачи. | Строка storyPoints | Значение параметра Story Points. | Число с плавающей точкой unique | Уникальный идентификатор задачи, который был задан при импорте. | Строка favorite | Добавил ли пользователь задачу в избранное
  • true — да;
  • false — нет.
| Логический **Поля объекта** `updatedBy` {#updatedBy} Параметр | Описание | Тип данных -------- | -------- | ---------- self | Адрес ресурса API, который содержит информацию о пользователе. | Строка id | Идентификатор пользователя. | Строка display | Отображаемое имя пользователя. | Строка **Поля объекта** `resolvedBy` {#resolvedBy} Параметр | Описание | Тип данных -------- | -------- | ---------- self | Адрес ресурса API, который содержит информацию о пользователе. | Строка id | Идентификатор пользователя. | Строка display | Отображаемое имя пользователя. | Строка **Поля объекта** `followingMaillists` {#followingMaillists} Параметр | Описание | Тип данных -------- | -------- | ---------- self | Адрес ресурса API, который содержит информацию о рассылке. | Строка id | Идентификатор рассылки. | Строка display | Отображаемое имя рассылки. | Строка **Поля объекта** `fixVersions` {#fixVersions} Параметр | Описание | Тип данных -------- | -------- | ---------- self | Адрес ресурса API, который содержит информацию о версии. | Строка id | Идентификатор версии. | Строка display | Имя версии. | Строка **Поля объекта** `type` {#type} Параметр | Описание | Тип данных -------- | -------- | ---------- self | Адрес ресурса API, который содержит информацию о типе задачи. | Строка id | Идентификатор типа задачи. | Строка key | Ключ типа задачи. | Строка display | Отображаемое название типа задачи. | Строка **Поля объекта** `priority` {#priority} Параметр | Описание | Тип данных -------- | -------- | ---------- self | Адрес ресурса API, который содержит информацию о приоритете. | Строка id | Идентификатор приоритета. | Строка key | Ключ приоритета. | Строка display | Отображаемое название приоритета. | Строка **Поля объекта** `resolution` {#resolution} Параметр | Описание | Тип данных -------- | -------- | ---------- self | Адрес ресурса API, который содержит информацию о резолюции. | Строка id | Идентификатор резолюции. | Строка key | Ключ резолюции. | Строка display | Отображаемое название резолюции. | Строка **Поля объекта** `followers` {#followers} Параметр | Описание | Тип данных -------- | -------- | ---------- self | Адрес ресурса API, который содержит информацию о пользователе. | Строка id | Идентификатор пользователя. | Строка display | Отображаемое имя пользователя. | Строка **Поля объекта** `assignee` {#assignee} Параметр | Описание | Тип данных -------- | -------- | ---------- self | Адрес ресурса API, который содержит информацию о пользователе. | Строка id | Идентификатор пользователя. | Строка display | Отображаемое имя пользователя. | Строка **Поля объекта** `createdBy` {#createdBy} Параметр | Описание | Тип данных -------- | -------- | ---------- self | Адрес ресурса API, который содержит информацию о пользователе. | Строка id | Идентификатор пользователя. | Строка display | Отображаемое имя пользователя. | Строка **Поля объекта** `affectedVersions` {#affectedVersions} Параметр | Описание | Тип данных -------- | -------- | ---------- self | Адрес ресурса API, который содержит информацию о версии. | Строка id | Идентификатор версии. | Строка display | Имя версии. | Строка **Поля объекта** `queue` {#queue} Параметр | Описание | Тип данных -------- | -------- | ---------- self | Адрес ресурса API, который содержит информацию об очереди. | Строка id | Идентификатор очереди. | Строка key | Ключ очереди. | Строка display | Имя очереди. | Строка **Поля объекта** `status` {#status} Параметр | Описание | Тип данных -------- | -------- | ---------- self | Адрес ресурса API, который содержит информацию о статусе. | Строка id | Идентификатор статуса. | Строка key | Ключ статуса. | Строка display | Отображаемое название статуса. | Строка **Поля объекта** `components` {#components} Параметр | Описание | Тип данных -------- | -------- | ---------- self | Адрес ресурса API, который содержит информацию о компоненте. | Строка id | Идентификатор компонента. | Строка key | Ключ компонента. | Строка display | Отображаемое название компонента. | Строка **Поля объекта** `access` {#access} Параметр | Описание | Тип данных -------- | -------- | ---------- self | Адрес ресурса API, который содержит информацию о версии. | Строка id | Идентификатор версии. | Строка display | Имя версии. | Строка {% endcut %} - Запрос выполнен с ошибкой Если запрос не был успешно обработан, ответное сообщение содержит информацию о возникших ошибках: 400 : Один или несколько параметров запроса имеют недопустимое значение. 403 : У вас не хватает прав на выполнение этого действия. Наличие прав можно перепроверить в интерфейсе Трекера — для выполнения действия при помощи API и через интерфейс требуются одинаковые права. 404 : Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта. 409 : При редактировании объекта возник конфликт. Возможно, ошибка возникла из-за неправильно указанной версии изменений. 422 : Ошибка валидации JSON, запрос отклонен. 500 : Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время. 503 : Сервис API временно недоступен. {% endlist %}