# Критические изменения

Узнайте о критических изменениях, которые были введены в каждой версии REST API.

## Сведения о критических изменениях в REST API

GitHub REST API имеет версии. Имя версии API основано на дате выпуска версии API. Например, версия `2026-03-10` API была выпущена на Tue, 10 Mar 2026.

Критические изменения — это изменения, которые могут потенциально нарушить интеграцию. Срочные изменения будут выпущены в новой версии API. Мы предупредим заранее перед публикацией нерешительных изменений. Критические изменения включают:

* Удаление всей операции
* Удаление или переименование параметра
* Удаление или переименование поля ответа
* Добавление нового обязательного параметра
* Создание ранее необязательного параметра
* Изменение типа поля параметра или ответа
* Удаление значений перечисления
* Добавление нового правила проверки в существующий параметр
* Изменение требований к проверке подлинности или авторизации

Любые некритивные изменения будут доступны во всех поддерживаемых версиях API. Аддитивные изменения — это изменения, которые не должны прерывать интеграцию. К аддитивным изменениям относятся:

* Добавление операции
* Добавление необязательного параметра
* Добавление необязательного заголовка запроса
* Добавление поля ответа
* Добавление заголовка ответа
* Добавление значений перечисления

При выпуске новой версии REST API предыдущая версия API будет поддерживаться не менее 24 месяцев после выпуска новой версии API.

Дополнительные сведения о версиях API см. в разделе [Версии API](/ru/enterprise-server@3.19/rest/about-the-rest-api/api-versions).

## Обновление до новой версии API

Перед обновлением до новой версии REST API необходимо прочитать раздел на этой странице, соответствующий новой версии API, чтобы понять, какие критические изменения включены и узнать больше о том, как обновить эту версию API.

Когда вы обновляете интеграцию, чтобы указать новую версию API в заголовке `X-GitHub-Api-Version`, вам также нужно внести необходимые изменения для работы с новой версией API.

После обновления интеграции проверьте интеграцию, чтобы убедиться, что она работает с новой версией API.

<!-- markdownlint-disable liquid-quoted-conditional-arg search-replace GHD046 -->