News YouTrack

Прекращаем поддержку устаревшего 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

Discover more