Yandex.Cloud
  • Сервисы
  • Почему Yandex.Cloud
  • Сообщество
  • Решения
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Yandex Tracker
  • Начало работы
    • Подключить Tracker
    • Настроить Tracker
    • Как работать в Tracker
      • Войти в Tracker
      • Начальная страница
      • Мои задачи
      • Как работать с задачей
      • Избранные задачи, доски, дашборды
      • Персональные настройки
    • Мигрировать в Tracker
    • Отключить платные услуги
  • Сценарии использования
    • Настроить Tracker для команды разработки
      • Обзор
      • Создать очередь для команды разработки
      • Структурировать задачи
      • Использовать гибкие методологии (Agile)
      • Настроить шаблоны задач
      • Подключить репозиторий
      • Автоматизировать рутинные действия
      • Интегрировать Tracker с другими системами
    • Настроить Tracker для службы поддержки
      • Обзор
      • Создать очередь для службы поддержки
      • Принимать обращения через форму
      • Настроить многоуровневую структуру поддержки
      • Группировать обращения по темам
      • Отслеживать время обработки обращений
      • Собирать статистику по обращениям
      • Настроить интеграцию со сторонними системами
  • Концепции
    • Обзор сервиса
    • Основные понятия
  • Настроить очередь
    • Обзор
    • Создать очередь
    • Шаблоны очередей
    • Просмотреть задачи очереди
    • Изменить основные параметры очереди
    • Настроить типы и статусы задач
      • Обзор
      • Настроить типы задач
      • Создать воркфлоу
      • Настроить статусы
      • Настроить переходы
      • Добавить типы задач, статусы, резолюции
        • Создать тип задачи
        • Создать статус
        • Создать резолюцию
    • Локальные поля задач
    • Добавить команду очереди
    • Настроить доступ к очереди
    • Расширенные возможности очереди
    • Посмотреть историю изменений очереди
    • Удалить очередь
  • Работать с задачами
    • Создать задачу
      • Обзор
      • Клонировать задачу
    • Редактировать задачу
      • Обзор
      • Добавить комментарии к задаче
      • Форматировать текст в задаче
      • Изменить связи задачи
      • Выполнить макрос
      • Изменить несколько задач
    • Создать чеклист
    • Настроить напоминание о задаче
    • Отметить затраченное время
    • Добавить поле задачи
    • Посмотреть историю изменений задачи
    • Проголосовать за задачу
    • Получить доступ к задаче
    • Удалить задачу
  • Структурировать задачи
    • Обзор
    • Связи между задачами
    • Проекты
    • Компоненты
    • Версии
  • Инструменты гибкой разработки
    • Обзор
    • Создать доску
    • Работать с доской
    • Изменить и удалить доску
    • Спринты
    • Эпики
    • Командная оценка задач
    • Диаграмма сгорания задач
  • Найти задачи
    • Обзор
    • Найти мои задачи
    • Найти задачи в очереди
    • Создать фильтр задач
    • Язык запросов
  • Уведомления и подписки
    • Обзор
    • Подписаться на уведомления
    • Получать отчет об изменениях
    • Подписать пользователей на изменения очереди
    • Настройки уведомлений
      • Обзор
      • Уведомления о ваших задачах
      • Уведомления о ваших подписках
  • Статистика и дашборды
    • Дашборды
      • Обзор
      • Как создать дашборд
      • Виджеты
      • Как изменить дашборд
      • Общий доступ к дашбордам
      • Как сделать дашборд начальной страницей
    • Статистика очереди
    • Диаграмма Гантта
  • Автоматизация и шаблоны
    • Обзор
    • Триггеры
      • Обзор
      • Создать триггер
      • Задать условие срабатывания триггера
      • Настроить действие триггера
      • Изменить и удалить триггер
      • Примеры
    • Автодействия
      • Обзор
      • Автоматическое обновление задач
      • Создание задач по расписанию
      • Изменить и удалить автодействие
    • Макросы
    • Шаблоны
      • Обзор
      • Создать шаблон
      • Изменить шаблон
      • Удалить шаблон
      • Использовать общие шаблоны
  • Настроить SLA для задач
    • Обзор
    • Настроить правила
    • Графики работы
  • Интеграция с другими сервисами
    • Формы
    • Вики
    • Мессенджеры
      • Обзор
      • Slack
      • Telegram
  • Инструменты разработчика
    • Плагин для IDE
    • API
    • Python клиент
    • Подключить репозиторий
  • Правила тарификации
  • Справочник API
    • Обзор
    • Доступ к API
    • Задачи
      • Получить параметры задачи
      • Редактировать задачу
      • Создать задачу
      • Перенести задачу в другую очередь
      • Узнать количество задач
      • Найти задачи
      • Освободить ресурсы просмотра прокрутки
      • Получить приоритеты
      • Получить связи задачи
      • Связать задачи
      • Получить переходы
      • Выполнить переход в статус
      • Получить историю изменений задачи
    • Чеклисты
      • Создать чеклист или добавить в него пункты
      • Получить параметры чеклиста
      • Редактировать чеклист
      • Удалить чеклист
    • Проекты
      • Создать проект
      • Получить параметры проекта
      • Получить список всех проектов
      • Получить список очередей проекта
      • Изменить проект
      • Удалить проект
    • Комментарии
      • Добавить комментарий
      • Получить комментарии к задаче
      • Редактировать комментарий
      • Удалить комментарий
    • Макросы
      • Получить макросы очереди
      • Получить макрос
      • Создать макрос
      • Редактировать макрос
      • Удалить макрос
    • Прикрепленные файлы
      • Получить список прикрепленных файлов
      • Скачать файл
      • Скачать миниатюру
      • Прикрепить файл
      • Загрузить временный файл
      • Удалить файл
    • Очереди
      • Создать очередь
      • Получить параметры очереди
      • Получить список очередей
      • Получить версии очереди
      • Получить обязательные поля очереди
      • Удалить очередь
      • Восстановить очередь
      • Удалить тег из очереди
    • Доски задач
      • Получить параметры всех досок
      • Получить параметры доски
      • Создать доску
      • Редактировать доску
      • Удалить доску
      • Колонки
        • Получить параметры всех колонок
        • Получить параметры колонки
        • Создать колонку
        • Редактировать колонку
        • Удалить колонку
      • Спринты
        • Получить все спринты доски
        • Получить спринт
        • Создать спринт
    • Импорт
      • Импортировать задачу
      • Импортировать файлы
      • Импортировать комментарии
      • Импортировать связи
    • Пакетные операции
      • Массовый перенос задач в другую очередь
      • Массовое редактирование задач
      • Массовое изменение статуса задач
    • Учет времени
      • Добавить запись о затраченном времени
      • Редактировать запись о затраченном времени
      • Удалить запись о затраченном времени
      • Получить записи о затраченном времени
        • Получить все записи по задаче
        • Отобрать записи по параметрам
    • Поля задачи
      • Получить параметры поля задачи
      • Изменить название поля задачи
      • Изменить возможные значения поля задачи
      • Создать категорию поля задачи
      • Локальные поля
        • Создать локальное поле очереди
        • Получить локальные поля очереди
        • Получить информацию о локальном поле очереди
        • Редактировать локальное поле очереди
    • Получить информацию о текущем пользователе
    • Возможные коды ответа
  • Вопросы и ответы
  • Служба поддержки
  1. Справочник API
  2. Импорт
  3. Импортировать связи

Импортировать связи

  • Формат запроса
  • Формат ответа

Важно

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

С помощью запроса вы можете импортировать в Tracker связи задачи с другими задачами.

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

Чтобы импортировать связь, используйте HTTP-запрос с методом POST. Параметры связи передаются в теле запроса в формате JSON:

POST /v2/issues/<issue_id>/links/_import
Host: https://api.tracker.yandex.netAuthorization: OAuth <токен>
X-Org-ID: <идентификатор организации>
Content-Type: application/json

{
  "relationship": "relates",
  "issue": "TEST-2",
  "createdAt": "2017-08-29T12:34:41.740+0000",
  "createdBy": 1110000000011111,
  "updatedAt": "2017-09-07T11:24:31.140+0000",
  "updatedBy": 1110000000011111
}

Ресурс

  • <issue_id>

    Ключ задачи, к которой будет прикреплен комментарий.

Заголовки запроса

  • Host

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

    https://api.tracker.yandex.net
    
  • Authorization

    OAuth-токен в формате OAuth <значение токена>, например:

    OAuth 0c4181a7c2cf4521964a72ff57a34a07
    
  • X-Org-ID

    Идентификатор организации.

  • Content-Type

    Формат тела запроса. Должен иметь значение application/json.

Тело запроса

Тело запроса содержит параметры комментария:

Параметр Описание Тип данных
relationship Тип связи между задачами:
  • relates — простая связь.
  • is dependent by — текущая задача является блокером.
  • depends on — текущая задача зависит от связываемой
  • is subtask for — текущая задача является подзадачей связываемой.
  • is parent task for — текущая задача является родительской для связываемой задачи.
  • duplicates — текущая задача дублирует связываемую.
  • is duplicated by — связываемая задача дублирует текущую.
  • is epic of — текущая задача является эпиком связываемой. Связь такого типа можно установить только для задач типа "Эпик".
  • has epic — связываемая задача является эпиком текущей. Связь такого типа можно установить только для задач типа "Эпик".
  • clone — связываемая задача является клоном текущей.
  • original — текущая задача является клоном связанной.
Строка
issue Идентификатор или ключ связываемой задачи. Строка.
createdAt Дата и время создания связи. формате YYYY-MM-DDThh:mm:ss.sss±hhmm. Вы можете указать время в интервале от создания до последнего обновления задач, между которыми устанавливается связь. Строка.
createdBy Логин или идентификатор создателя связи.
  • Строка для логина.
  • - Число для идентификатора.
updatedAt Дата и время последнего изменения связи. формате YYYY-MM-DDThh:mm:ss.sss±hhmm. Вы можете указать время в интервале от создания до последнего обновления задач, между которыми устанавливается связь.

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

Параметр указывается только вместе с параметром updatedAt.
  • Строка для логина.
  • Число для идентификатора.

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

Запрос выполнен успешно
Запрос выполнен с ошибкой

В случае успешного выполнения запроса API возвращает ответ с кодом 201. Тело запроса содержит информацию о импортированной задаче в формате JSON.

{
        "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 Блок с информацией о типе связи. Объект.
sdirection Тип связи задачи, указанной в запросе, по отношению к задаче в поле object . Возможны следующие значения:
  • outward — задача, указанная в запросе, является основной для задачи в поле object.
  • inward — задача в поле object является основной для задачи, указанной в запросе.
Строка.
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 Отображаемое название статуса. Строка.

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

HTTP-код ошибки Описание ошибки
400 Bad Request Один из параметров запроса имеет недопустимое значение или формат данных.
403 Forbidden У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.
404 Not Found Запрашиваемый ресурс не найден.
422 Unprocessable Entity Ошибка валидации JSON, запрос отклонен.
500 Internal Server Error Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.
503 Service Unavailable Сервис API временно недоступен.
В этой статье:
  • Формат запроса
  • Формат ответа
Language / Region
Вакансии
Политика конфиденциальности
Условия использования
Брендбук
© 2021 ООО «Яндекс.Облако»