Получить связи задачи
Запрос позволяет получить информацию связях задачи. Задача выбирается при указании идентификатора или ключа задачи.
Формат запроса
Для получения списка связей задачи используйте HTTP-запрос с методом GET
:
GET /v2/issues/<issue-id>/links
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-Id: <идентификатор организации>
- <issue-id>
- Идентификатор или ключ задачи.
Запрос связей задачи:
Используется HTTP-метод GET.
GET /v2/issues/JUNE-2/links HTTP/1.1
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-Id: <идентификатор организации>
Cache-Control: no-cache
Формат ответа
[
{
"self": "https://api.tracker.yandex.net/v2/issues/JUNE-2/links/4709605",
"id": 4709605,
"type": {
"self": "https://api.tracker.yandex.net/v2/linktypes/subtask",
"id": "subtask",
"inward": "Подзадача",
"outward": "Родительская задача"
},
"direction": "outward",
"object": {
"self": "https://api.tracker.yandex.net/v2/issues/TREK-9844",
"id": "593cd211ef7e8a332414f2a7",
"key": "TREK-9844"
"display": "subtask"
},
"createdBy": {
"self": "https://api.tracker.yandex.net/v2/users/1120000000049224",
"id": "<id сотрудника>",
"display": "<отображаемое имя сотрудника>"
},
"updatedBy": {
"self": "https://api.tracker.yandex.net/v2/users/1120000000049224",
"id": "<id сотрудника>",
"display": "<отображаемое имя сотрудника>"
},
"createdAt": "2017-06-11T05:16:01.421+0000",
"updatedAt": "2017-06-11T05:16:01.421+0000",
"assignee": {
"self": "https://api.tracker.yandex.net/v2/users/1120000000049224",
"id": "<id сотрудника>",
"display": "<отображаемое имя сотрудника>"
},
"status": {
"self": "https://api.tracker.yandex.net/v2/statuses/1",
"id": "1",
"key": "open",
"display": "Открыт"
}
},
...
]
Параметр | Описание | Тип данных |
---|---|---|
self | Адрес ресурса API, который содержит информацию о связи. | Строка. |
id | Идентификатор связи. | Число. |
type | Блок с информацией о типе связи. | Объект. |
direction | Строка. | |
object | Блок с информацией о связанной задаче. | Объект. |
createdBy | Блок с информацией о создателе связи. | Объект. |
updatedBy | Блок с информацией о последнем изменившем связанную задачу пользователе. | Объект. |
createdAt | Дата и время создания связи. | Строка. |
updatedAt | Дата и время изменения связи. | Строка. |
assignee | Исполнитель связанной задачи. | Объект. |
status | Статус связанной задачи. | Объект. |
Поля объекта type | ||
self | Ссылка на тип связи. | Строка. |
id | Идентификатор типа связи. | Строка. |
inward | Название типа связи задачи в поле object по отношению к задаче, указанной в запросе. | Строка. |
outward | Название типа связи задачи, указанной в запросе, по отношению к задаче в поле object. | Строка. |
Поля объекта object | ||
self | Адрес ресурса API, который содержит информацию о задаче. | Строка. |
id | Идентификатор задачи. | Строка. |
key | Ключ задачи. | Строка |
display | Отображаемое название задачи. | Строка. |
Поля объекта createdBy | ||
self | Ссылка на пользователя Трекера. | Строка. |
id | Идентификатор пользователя. | Строка. |
display | Отображаемое имя пользователя. | Строка. |
Поля объекта updatedBy | ||
self | Ссылка на пользователя Трекера. | Строка. |
id | Идентификатор пользователя. | Строка. |
display | Отображаемое имя пользователя. | Строка. |
Поля объекта assignee | ||
self | Ссылка на пользователя Трекера. | Строка. |
id | Идентификатор пользователя. | Строка. |
display | Отображаемое имя пользователя. | Строка. |
Поля объекта status | ||
self | Ссылка на статус. | Строка. |
id | Идентификатор статуса. | Строка. |
key | Ключ статуса. | Строка. |
display | Отображаемое название статуса. | Строка. |
Параметр | Описание | Тип данных |
---|---|---|
self | Адрес ресурса API, который содержит информацию о связи. | Строка. |
id | Идентификатор связи. | Число. |
type | Блок с информацией о типе связи. | Объект. |
direction | Строка. | |
object | Блок с информацией о связанной задаче. | Объект. |
createdBy | Блок с информацией о создателе связи. | Объект. |
updatedBy | Блок с информацией о последнем изменившем связанную задачу пользователе. | Объект. |
createdAt | Дата и время создания связи. | Строка. |
updatedAt | Дата и время изменения связи. | Строка. |
assignee | Исполнитель связанной задачи. | Объект. |
status | Статус связанной задачи. | Объект. |
Поля объекта type | ||
self | Ссылка на тип связи. | Строка. |
id | Идентификатор типа связи. | Строка. |
inward | Название типа связи задачи в поле object по отношению к задаче, указанной в запросе. | Строка. |
outward | Название типа связи задачи, указанной в запросе, по отношению к задаче в поле object. | Строка. |
Поля объекта object | ||
self | Адрес ресурса API, который содержит информацию о задаче. | Строка. |
id | Идентификатор задачи. | Строка. |
key | Ключ задачи. | Строка |
display | Отображаемое название задачи. | Строка. |
Поля объекта createdBy | ||
self | Ссылка на пользователя Трекера. | Строка. |
id | Идентификатор пользователя. | Строка. |
display | Отображаемое имя пользователя. | Строка. |
Поля объекта updatedBy | ||
self | Ссылка на пользователя Трекера. | Строка. |
id | Идентификатор пользователя. | Строка. |
display | Отображаемое имя пользователя. | Строка. |
Поля объекта assignee | ||
self | Ссылка на пользователя Трекера. | Строка. |
id | Идентификатор пользователя. | Строка. |
display | Отображаемое имя пользователя. | Строка. |
Поля объекта status | ||
self | Ссылка на статус. | Строка. |
id | Идентификатор статуса. | Строка. |
key | Ключ статуса. | Строка. |
display | Отображаемое название статуса. | Строка. |
Возможные коды ответа
- 200
- Запрос выполнен успешно.
- 404
- Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.