YouTrack
Powerful project management for all your teams
Публикации и ответы на комментарии в блогах JetBrains не выходят на русском языке с 2022 года.
Приносим извинения за неудобства.
Прекращаем поддержку устаревшего REST API: что вам нужно сделать
Мы хотим напомнить о важных изменениях в технической стороне построения интеграций между YouTrack и внешними инструментами. До конца июня 2021 года администраторам YouTrack и тем, кто отвечает за настройку внешних интеграций, необходимо выполнить определенные действия.
Что меняется
Два года назад мы начали постепенно публиковать новые ресурсы и методы REST API. Мы постарались сделать новый API максимально безопасным и гибким, чтобы вы могли эффективно создавать собственные интеграции. Это также позволило нам избавиться от проблем, с которыми приходилось иметь дело в устаревшем API.
Теперь новый REST API полностью поддерживается, и мы хотим сосредоточиться на его улучшении. Поэтому пришло время прекратить поддержку устаревших методов.
Мы планируем начать переход в июле и завершить процесс к концу 2021 года. Мы, конечно же, переведем все наши официальные библиотеки, плагины и виджеты на новый API, прежде чем отключать устаревший.
Какие методы считаются устаревшими
Методы REST API в основном используются для создания интеграций между YouTrack и другими инструментами, чтобы получить дополнительную функциональность. Например, с помощью таких интеграций можно выгружать задачи из YouTrack и строить различные диаграммы на основе полученных данных. Если ваша команда пользуется такими интеграциями, найдите время посмотреть, какие методы там содержатся. В устаревших методах используется URL-префикс /rest, а в новых — /api.
Что нужно сделать
По завершении перехода нельзя будет использовать устаревший REST API в версиях YouTrack, выпущенных в июле 2021 года и позже. Все пользовательские интеграции, построенные на устаревших методах, тоже перестанут работать. Поэтому вам необходимо перевести весь свой код на новый REST API до июля 2021 года. С 1 июля 2021 года мы не сможем гарантировать, что устаревшие методы REST API будут работать.
В документации вы найдете подробные описания новых конечных точек, а также набор примеров, которые помогут вам ознакомиться с новым API.
Что будет с интеграциями
Мы понимаем, что в некоторых случаях наши пользователи не могут повлиять на интеграции с популярными инструментами, например с системами управления тестированием. Мы планируем связаться с разработчиками такого ПО: сообщим о предстоящих изменениях и предоставим всю необходимую помощь, чтобы эти интеграции точно были переведены на новый REST API.
Если у вас есть вопросы или вам нужна помощь с переводом интеграций на новый API, свяжитесь с нашей службой поддержки. Мы всегда рады помочь.
Ваша команда YouTrack
The Drive to Develop
Subscribe to YouTrack Blog updates
