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

Получить историю изменений задачи

Статья создана
Yandex Cloud
  • Формат запроса
  • Формат ответа

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

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

Перед выполнением запроса получите доступ к API.

Чтобы получить список изменений задачи, используйте HTTP-запрос с методом GET.

GET /v2/issues/<issue-id>/changelog
Host: https://api.tracker.yandex.net
Authorization: OAuth <токен>
X-Org-ID: <идентификатор организации>
Заголовки
  • Host

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

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

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

    OAuth 0c4181a7c2cf4521964a72ff57a34a07
    
  • X-Org-ID

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

Ресурс
Параметр Описание Тип данных
<issue-id> Идентификатор или ключ текущей задачи. Строка
Параметры запроса

Дополнительные параметры

Параметр Описание Тип данных
id Идентификатор изменения, за которым следуют запрашиваемые изменения. Строка
perPage Количество изменений на странице. Если параметр не указан, по умолчанию на странице будет выведено 50 изменений. Число
field Идентификатор параметра изменений. Например, checklistItems для просмотра изменений в чеклисте или status для просмотра всех обновлений статуса задачи. Строка
type Ключ типа изменения. Строка

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

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

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

Тело ответа содержит JSON-массив с историей изменений задачи.

Заголовки ответа

Заголовки Link содержат ссылки на первую (rel="first") и последующую (rel="next") страницы ответа. По умолчанию на каждой странице располагается 50 изменений.

...
Link: <https://api.tracker.yandex.net/v2/issues/SCR-8/changelog?perPage=50>; rel="first"
Link: <https://api.tracker.yandex.net/v2/issues/SCR-8/changelog?id=5b9a1a88f7c605001c0e14a5&perPage=50>; rel="next"
...
[
 {
     "id": "6033f986bd6c4a042c688392",
     "self": "https://api.tracker.yandex.net/v2/issues/TEST-27/changelog/6033f986bd6c4a042c688392",
     "issue": {
         "self": "https://api.tracker.yandex.net/v2/issues/TEST-27",
         "id": "6033f986bd6c4a042c688392",
         "key": "TEST-27",
         "display": "Название задачи"
     },
     "updatedAt": "2021-02-22T18:35:50.157+0000",
     "updatedBy": {
         "self": "https://api.tracker.yandex.net/v2/users/1234567890",
         "id": "1234567890",
         "display": "Имя Фамилия"
     },
     "type": "IssueCreated",
     "transport": "front",
     "fields": [
         {
             "field": {
                 "self": "https://api.tracker.yandex.net/v2/fields/status",
                 "id": "status",
                 "display": "Статус"
             },
             "from": null,
             "to": {
                 "self": "https://api.tracker.yandex.net/v2/statuses/1",
                 "id": "1",
                 "key": "open",
                 "display": "Открыт"
             }
         }
     ]
 },
 {
     "id": "6033f98d4417c101b655b93b",
     "self": "https://api.tracker.yandex.net/v2/issues/TEST-27/changelog/6033f98d4417c101b655b93b",
     "issue": {
         "self": "https://api.tracker.yandex.net/v2/issues/TEST-27",
         "id": "6033f986bd6c4a042c688391",
         "key": "TEST-27",
         "display": "Название задачи"
     },
     "updatedAt": "2021-02-22T18:35:57.359+0000",
     "updatedBy": {
         "self": "https://api.tracker.yandex.net/v2/users/1234567890",
         "id": "1234567890",
         "display": "Имя Фамилия"
     },
     "type": "IssueUpdated",
     "transport": "front",
     "fields": [
         {
             "field": {
                 "self": "https://api.tracker.yandex.net/v2/fields/followers",
                 "id": "followers",
                 "display": "Наблюдатели"
             },
             "from": null,
             "to": [
                 {
                     "self": "https://api.tracker.yandex.net/v2/users/1234567890",
                     "id": "1234567890",
                     "display": "Имя Фамилия"
                 }
             ]
         }
     ]
 },
 {
     "id": "6033f9954417c101b655b940",
     "self": "https://api.tracker.yandex.net/v2/issues/TEST-27/changelog/6033f9954417c101b655b940",
     "issue": {
         "self": "https://api.tracker.yandex.net/v2/issues/TEST-27",
         "id": "6033f986bd6c4a042c688391",
         "key": "TEST-27",
         "display": "Название задачи"
     },
     "updatedAt": "2021-02-22T18:36:05.553+0000",
     "updatedBy": {
         "self": "https://api.tracker.yandex.net/v2/users/1234567890",
         "id": "1234567890",
         "display": "Имя Фамилия"
     },
     "type": "IssueUpdated",
     "transport": "front",
     "fields": [
         {
             "field": {
                 "self": "https://api.tracker.yandex.net/v2/fields/tags",
                 "id": "tags",
                 "display": "Теги"
             },
             "from": null,
             "to": [
                 "Новый тег"
             ]
         }
     ],
 },
 {
    "id": "62bab52ca16f631eea3816a9",
    "self": "https://api.tracker.yandex.net/v2/issues/TEST-27/changelog/62bab52ca16f631eea3816a9",
    "issue": {
        "self": "https://api.tracker.yandex.net/v2/issues/TEST-27",
        "id": "5fbc929b5b28572f9418327d",
        "key": "TEST-27",
        "display": "Название задачи"
    },
    "updatedAt": "2022-06-28T08:00:44.155+0000",
    "updatedBy": {
        "self": "https://api.tracker.yandex.net/v2/users/1134669289",
        "id": "1134669289",
        "display": "Имя Фамилия"
    },
    "type": "IssueWorkflow",
    "transport": "front",
    "fields": [
        {
            "field": {
                "self": "https://api.tracker.yandex.net/v2/fields/status",
                "id": "status",
                "display": "Статус"
            },
            "from": {
                "self": "https://api.tracker.yandex.net/v2/statuses/3",
                "id": "3",
                "key": "inProgress",
                "display": "В работе"
            },
            "to": {
                "self": "https://api.tracker.yandex.net/v2/statuses/2",
                "id": "2",
                "key": "needInfo",
                "display": "Требуется информация"
            }
        },
        {
            "field": {
                "self": "https://api.tracker.yandex.net/v2/fields/statusStartTime",
                "id": "statusStartTime",
                "display": "Статус изменен"
            },
            "from": "2022-06-28T07:29:45.753+0000",
            "to": "2022-06-28T08:00:44.156+0000"
        },
        {
            "field": {
                "self": "https://api.tracker.yandex.net/v2/fields/followers",
                "id": "followers",
                "display": "Наблюдатели"
            },
            "from": [
                {
                    "self": "https://api.tracker.yandex.net/v2/users/780889736",
                    "id": "780889736",
                    "display": "Имя Фамилия"
                },
                {
                    "self": "https://api.tracker.yandex.net/v2/users/780891246",
                    "id": "780891246",
                    "display": "Имя Фамилия"
                }
            ],
            "to": [
                {
                    "self": "https://api.tracker.yandex.net/v2/users/780889736",
                    "id": "780889736",
                    "display": "Имя Фамилия"
                },
                {
                    "self": "https://api.tracker.yandex.net/v2/users/780891246",
                    "id": "780891246",
                    "display": "Имя Фамилия"
                },
                {
                    "self": "https://api.tracker.yandex.net/v2/users/1134669289",
                    "id": "1134669289",
                    "display": "Имя Фамилия"
                }
            ]
        }
    ], 
    "comments": {
        "added": [
            {
                "self": "https://api.tracker.yandex.net/v2/issues/TEST-27/comments/10",
                "id": "10",
                "display": "<текст комментария>"
            }
        ]
    },
    "executedTriggers": [
        {
            "trigger": {
                "self": "https://api.tracker.yandex.net/v2/queues/TEST/triggers/29",
                "id": "29",
                "display": "<имя триггера>"
            },
            "success": true,
            "message": "<действие триггера>"
        }
     ]
  }
]
Параметры ответа
Параметр Описание Тип данных
id Идентификатор изменения. Строка
self Адрес ресурса API, который содержит информацию об изменении. Строка
issue Блок с информацией о задаче. Объект
updatedAt Дата и время изменения задачи в формате YYYY-MM-DDThh:mm:ss.sss±hhmm. Строка
updatedBy Блок с информацией о пользователе, который внес изменение в задачу. Объект
transport Служебный параметр. Строка
type Тип изменения. Строка
fields Массив объектов с информацией об измененных параметрах задачи. Массив объектов
comments Блок с информацией о комментарии к задаче. Объект
executedTriggers Блок с информацией о триггере, который сработал в задаче. Объект

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

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о задаче. Строка
id Идентификатор задачи. Строка
key Ключ задачи. Строка
display Отображаемое название задачи. Строка

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

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о пользователе. Строка
id Идентификатор пользователя. Строка
display Отображаемое имя пользователя. Строка

Поля объектов массива fields

Параметр Описание Тип данных
field Блок с информацией об измененном параметре задачи. Объект
from Информация о значении параметра до изменения.
  • Если в поле можно записать несколько значений, то передается массив объектов. Например, поле followers.
  • Если в поле можно записать только одно значение, то оно передается в строковом формате. Например, поле statusStartTime.
Строка / Объект
to Информация о значении параметра после изменения.
  • Если в поле можно записать несколько значений, то передается массив объектов. Например, поле followers.
  • Если в поле можно записать только одно значение, то оно передается в строковом формате. Например, поле statusStartTime.
Строка / Объект

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

Параметр Описание Тип данных
self Ссылка на измененный параметр задачи. Строка
id Идентификатор параметра задачи. Строка
display Отображаемое название параметра задачи. Строка

Поля объектов from и to

Параметр Описание Тип данных
self Ссылка на значение параметра задачи. Строка
id Идентификатор значения параметра задачи. Строка
key Ключ значения параметра. Строка
display Отображаемое название значения параметра. Строка

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

Параметр Описание Тип данных
added Блок с информацией о комментарии. Объект

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

Параметр Описание Тип данных
self Ссылка на объект комментария. Строка
id Идентификатор комментария. Число
display Текст комментария. Строка

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

Параметр Описание Тип данных
trigger Блок с информацией о триггере. Объект
success Статус срабатывания триггера. Допустимые значения:
  • true— успешно;
  • false— неуспешно.
Логический
message Действие, которое было выполнено при срабатывании триггера. Строка

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

Параметр Описание Тип данных
self Ссылка на объект триггера. Строка
id Идентификатор триггера. Число
display Отображаемое название триггера. Строка

Тип изменения type

Тип изменения Описание
IssueUpdated Задача изменена.
IssueCreated Задача создана.
IssueMoved Задача перемещена в другую очередь.
IssueCloned Создан клон задачи.
IssueCommentAdded Добавлен комментарий к задаче.
IssueCommentUpdated Изменен комментарий к задаче.
IssueCommentRemoved Удален комментарий к задаче.
IssueWorklogAdded Добавлена запись о затраченном времени.
IssueWorklogUpdated Изменена запись о затраченном времени.
IssueWorklogRemoved Удалена запись о затраченном времени.
IssueCommentReactionAdded За комментарий проголосовали.
IssueCommentReactionRemoved Отозван голос за комментарий.
IssueVoteAdded За задачу проголосовали.
IssueVoteRemoved Отозван голос за задачу.
IssueLinked Создана связь с другой задачей.
IssueLinkChanged Изменен тип связи с другой задачей.
IssueUnlinked Удалена связь с другой задачей.
RelatedIssueResolutionChanged Изменена резолюция связанной задачи.
IssueAttachmentAdded К задаче прикреплен файл.
IssueAttachmentRemoved Прикрепленный к задаче файл удален.
IssueWorkflow Изменен статус задачи.

Если запрос не был успешно обработан, API возвращает ответ с кодом ошибки:

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

Была ли статья полезна?

Language / Region
Проект Яндекса
© 2023 ООО «Яндекс.Облако»
В этой статье:
  • Формат запроса
  • Формат ответа