9 ноября Atlassian перенесла отключение старых методов REST API для значений пользовательских полей Jira Cloud на июль 2027 года. Изменение важно для приложений и скриптов, которые читают или записывают значения по умолчанию в контекстах полей. На Mentoring.digital разбираем, что можно перевести на новый API уже сейчас.
Когда доступны новые методы
Старые GET и PUT используют окончание пути /context/defaultValue. У новых методов последнее слово во множественном числе, /context/defaultValues. Поле по-прежнему определяется параметром fieldId в пути.
- 4 ноября новый GET стал общедоступным. Его уже можно проверять на чтении.
- На ноябрь и декабрь 2026 года Atlassian запланировала ранний доступ к новому PUT и нескольким значениям по умолчанию в одном контексте.
- Общий запуск этих двух возможностей намечен на январь 2027 года. Старые методы снимут в июле 2027 года по обновлённому графику.
Что проверить в интеграции
Ответ нового GET разбит на страницы. В каждой записи есть идентификатор контекста contextId и список defaultValues. Значение может относиться к конкретному типу задачи через issueTypeId или быть общим для типов задач в контексте.
- Найдите вызовы старого пути в клиенте, фоновых заданиях и тестах. Разделите чтение и запись, чтобы выпускать их независимо.
- Сравните ответы на тестовом поле. Проверьте обработку нескольких страниц, пустого списка и выбора значения для типа задачи.
- Запись через новый PUT проверьте на тестовом поле после появления доступа. Затем прочитайте поле новым GET и сравните значения с ожидаемыми.
Схему ответа и тесты для постепенного перехода можно разобрать с наставником по проектированию REST API.
