Перенести задачу в другую очередь с помощью запроса к API
Запрос позволяет переместить задачу в другую очередь.
Перед выполнением запроса убедитесь, что пользователь имеет доступ к редактированию переносимых задач и их созданию в новой очереди.
Важно
Если переносимая задача имеет тип и статус, которые не существуют в новой очереди, перенос не будет выполнен. Чтобы при переносе сбросить статус задачи в начальное значение, используйте параметр InitialStatus
.
По умолчанию при переносе очищаются значения компонентов, версий и проектов задачи. Если в новой очереди настроены аналогичные значения для этих полей, для переноса компонентов, версий и проектов используйте параметр MoveAllFields
.
Если в задаче установлены значения локальных полей, при переносе в другую очередь они будут удалены.
Формат запроса
Перед выполнением запроса получите доступ к API.
Для переноса задачи используйте HTTP-запрос с методом POST
:
POST /v2/issues/<ключ_или_идентификатор_задачи>/_move?queue=<ключ_или_идентификатор_очереди>
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
Заголовки
-
Host
Адрес узла, предоставляющего API:
api.tracker.yandex.net
-
Authorization
OAuth-токен в формате
OAuth <OAuth-токен>
, например:OAuth 0c4181a7c2cf4521964a72ff********
-
X-Org-ID или X-Cloud-Org-ID
Идентификатор организации. Узнать его можно на странице организаций Tracker
.- Если к Tracker привязана только организация Яндекс 360 для бизнеса, используется заголовок
X-Org-ID
. - Если к Tracker привязана только организация Yandex Cloud Organization, используется заголовок
X-Cloud-Org-ID
. - Если к Tracker одновременно привязаны организации Яндекс 360 для бизнеса и Yandex Cloud Organization, используется заголовок
X-Org-ID
и идентификатор организации Яндекс 360 для бизнеса.
- Если к Tracker привязана только организация Яндекс 360 для бизнеса, используется заголовок
Ресурс
Параметр | Описание | Тип данных |
---|---|---|
<ключ_или_идентификатор_задачи> | Идентификатор или ключ текущей задачи. | Строка |
Параметры запроса
Обязательные параметры
Параметр | Описание | Тип данных |
---|---|---|
<ключ_или_идентификатор_очереди> | Ключ очереди, в которую необходимо перенести задачу. | Строка |
Дополнительные параметры
Параметр | Описание | Тип данных |
---|---|---|
notify | Признак уведомления об изменении задачи:
|
Логический |
notifyAuthor | Признак уведомления автора задачи:
|
Логический |
moveAllFields | Перенос версий, компонентов и проектов задачи в новую очередь:
|
Логический |
initialStatus | Сброс статуса задачи в начальное значение. Статус необходимо сбросить, если задача переносится в очередь с другим воркфлоу:
|
Логический |
expand | Дополнительные поля, которые будут включены в ответ:
|
Строка |
Параметры тела запроса
Тело запроса можно использовать в случае, если требуется изменить параметры переносимой задачи. Тело имеет такой же формат, как и при редактировании задачи.
Пример: Перенести задачу
- Используется HTTP-метод POST.
- Задача «TEST-1» перемещается в очередь «NEW».
POST /v2/issues/TEST-1/_move?queue=NEW Host: api.tracker.yandex.net Authorization: OAuth <OAuth-токен> X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
Формат ответа
В случае успешного выполнения запроса API возвращает ответ с кодом 200 OK
.
Тело ответа содержит результаты в формате JSON.
{
"self": "https://api.tracker.yandex.net/v2/issues/NEW-1",
"id": "1a********",
"key": "NEW-1",
"version": 2,
"aliases": [
"TEST-1"
],
"previousQueue": {
"self": "https://api.tracker.yandex.net/v2/queues/TEST",
"id": "3",
"key": "TEST",
"display": "TEST"
},
"description": "Перенести задачу в другую очередь",
"type": {
"self": "https://api.tracker.yandex.net/v2/issuetypes/2",
"id": "2",
"key": "task",
"display": "Задача"
},
"createdAt": "2020-09-04T14:18:56.776+0000",
"updatedAt": "2020-11-12T12:38:19.040+0000",
"lastCommentUpdatedAt": "2020-10-18T13:33:44.291+0000",
},
"summary": "Тест",
"updatedBy": {
"self": "https://api.tracker.yandex.net/v2/users/12********",
"id": "12********",
"display": "Иван Иванов"
},
"priority": {
"self": "https://api.tracker.yandex.net/v2/priorities/3",
"id": "3",
"key": "normal",
"display": "Средний"
},
"followers": [
{
"self": "https://api.tracker.yandex.net/v2/users/12********",
"id": "12********",
"display": "Иван Иванов"
}
],
"createdBy": {
"self": "https://api.tracker.yandex.net/v2/users/12********",
"id": "12********",
"display": "Иван Иванов"
},
"assignee": {
"self": "https://api.tracker.yandex.net/v2/users/12********",
"id": "12********",
"display": "Иван Иванов"
},
"queue": {
"self": "https://api.tracker.yandex.net/v2/queues/NEW",
"id": "5",
"key": "NEW",
"display": "Очередь"
},
"status": {
"self": "https://api.tracker.yandex.net/v2/statuses/8",
"id": "1",
"key": "open",
"display": "Открыт"
},
"previousStatus": {
"self": "https://api.tracker.yandex.net/v2/statuses/1",
"id": "1",
"key": "open",
"display": "Открыт"
},
"favorite": false
}
Параметры ответа
Параметр | Описание | Тип данных |
---|---|---|
self | Адрес ресурса API, который содержит информацию о задаче. | Строка |
id | Идентификатор задачи. | Строка |
key | Ключ задачи. | Строка |
version | Версия задачи. Каждое изменение параметров задачи увеличивает номер версии. | Число |
aliases | Массив с информацией об альтернативных ключах задачи. | Массив строк |
previousQueue | Объект с информацией о предыдущей очереди задачи. | Объект |
description | Описание задачи. | Строка |
type | Объект с информацией о типе задачи. | Объект |
createdAt | Дата и время создания задачи. | Строка |
updatedAt | Дата и время обновления задачи. | Строка |
lastCommentUpdatedAt | Дата и время последнего добавленного комментария. | Строка |
summary | Название задачи. | Строка |
updatedBy | Объект с информацией о последнем пользователе, изменявшим задачу. | Объект |
priority | Объект с информацией о приоритете. | Объект |
followers | Массив объектов с информацией о наблюдателях задачи. | Массив строк |
createdBy | Объект с информацией о создателе задачи. | Объект |
assignee | Объект с информацией об исполнителе задачи. | Объект |
queue | Объект с информацией об очереди задачи. | Объект |
status | Объект с информацией о статусе задачи. | Объект |
previousStatus | Объект с информацией о предыдущем статусе задачи. | Объект |
favorite | Признак избранной задачи:
|
Логический |
Поля объекта previousQueue
Параметр | Описание | Тип данных |
---|---|---|
self | Адрес ресурса API, который содержит информацию об очереди. | Строка |
id | Идентификатор очереди. | Строка |
key | Ключ очереди. | Строка |
display | Отображаемое название очереди. | Строка |
Поля объекта type
Параметр | Описание | Тип данных |
---|---|---|
self | Адрес ресурса API, который содержит информацию о типе задаче. | Строка |
id | Идентификатор типа задачи. | Строка |
key | Ключ типа задачи. | Строка |
display | Отображаемое название типа задачи. | Строка |
Поля объекта updatedBy
Параметр | Описание | Тип данных |
---|---|---|
self | Адрес ресурса API, который содержит информацию о пользователе. | Строка |
id | Идентификатор пользователя. | Строка |
display | Отображаемое имя пользователя. | Строка |
passportUid | Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. | Число |
Поля объекта priority
Параметр | Описание | Тип данных |
---|---|---|
self | Адрес ресурса API, который содержит информацию о приоритете. | Строка |
id | Идентификатор приоритета. | Строка |
key | Ключ приоритета. | Строка |
display | Отображаемое название приоритета. | Строка |
Поля массива объектов followers
Параметр | Описание | Тип данных |
---|---|---|
self | Адрес ресурса API, который содержит информацию о пользователе. | Строка |
id | Идентификатор пользователя. | Строка |
display | Отображаемое имя пользователя. | Строка |
passportUid | Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. | Число |
Поля объекта createdBy
Параметр | Описание | Тип данных |
---|---|---|
self | Адрес ресурса API, который содержит информацию о пользователе. | Строка |
id | Идентификатор пользователя. | Строка |
display | Отображаемое имя пользователя. | Строка |
passportUid | Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. | Число |
Поля объекта assignee
Параметр | Описание | Тип данных |
---|---|---|
self | Адрес ресурса API, который содержит информацию о пользователе. | Строка |
id | Идентификатор пользователя. | Строка |
display | Отображаемое имя пользователя. | Строка |
passportUid | Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. | Число |
Поля объекта queue
Параметр | Описание | Тип данных |
---|---|---|
self | Адрес ресурса API, который содержит информацию об очереди. | Строка |
id | Идентификатор очереди. | Строка |
key | Ключ очереди. | Строка |
display | Отображаемое название очереди. | Строка |
Поля объекта status
Параметр | Описание | Тип данных |
---|---|---|
self | Адрес ресурса API, который содержит информацию о статусе. | Строка |
id | Идентификатор статуса. | Строка |
key | Ключ статуса. | Строка |
display | Отображаемое название статуса. | Строка |
Поля объекта previousStatus
Параметр | Описание | Тип данных |
---|---|---|
self | Адрес ресурса API, который содержит информацию о статусе. | Строка |
id | Идентификатор статуса. | Строка |
key | Ключ статуса. | Строка |
display | Отображаемое название статуса. | Строка |
Если запрос не был успешно обработан, API возвращает ответ с кодом ошибки:
- 401
- Пользователь не авторизован. Проверьте, были ли выполнены действия, описанные в разделе Доступ к API.
- 403
- У вас не хватает прав на выполнение этого действия. Наличие прав можно перепроверить в интерфейсе Tracker — для выполнения действия при помощи API и через интерфейс требуются одинаковые права.
- 404
- Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.