{"meta":{"title":"Версии API","intro":"Узнайте, как указать, какую версию REST API следует использовать при каждом запросе к REST API.","product":"REST API","breadcrumbs":[{"href":"/ru/rest","title":"REST API"},{"href":"/ru/rest/about-the-rest-api","title":"Сведения о REST API"},{"href":"/ru/rest/about-the-rest-api/api-versions","title":"Версии API"}],"documentType":"article"},"body":"# Версии API\n\nУзнайте, как указать, какую версию REST API следует использовать при каждом запросе к REST API.\n\n## Сведения о управлении версиями API\n\nGitHub REST API имеет версии. Имя версии API основано на дате выпуска версии API. Например, версия `2026-03-10` API была выпущена на Tue, 10 Mar 2026.\n\nКритические изменения — это изменения, которые могут потенциально нарушить интеграцию. Срочные изменения будут выпущены в новой версии API. Мы предупредим заранее перед публикацией нерешительных изменений. Критические изменения включают:\n\n* Удаление всей операции\n* Удаление или переименование параметра\n* Удаление или переименование поля ответа\n* Добавление нового обязательного параметра\n* Создание ранее необязательного параметра\n* Изменение типа поля параметра или ответа\n* Удаление значений перечисления\n* Добавление нового правила проверки в существующий параметр\n* Изменение требований к проверке подлинности или авторизации\n\nЛюбые некритивные изменения будут доступны во всех поддерживаемых версиях API. Аддитивные изменения — это изменения, которые не должны прерывать интеграцию. К аддитивным изменениям относятся:\n\n* Добавление операции\n* Добавление необязательного параметра\n* Добавление необязательного заголовка запроса\n* Добавление поля ответа\n* Добавление заголовка ответа\n* Добавление значений перечисления\n\nПри выпуске новой версии REST API предыдущая версия API будет поддерживаться не менее 24 месяцев после выпуска новой версии API.\n\n## Указание версии API\n\nВам следует использовать заголовок `X-GitHub-Api-Version` для указания версии API. Например:\n\n```shell\ncurl --header \"X-GitHub-Api-Version:2026-03-10\" https://api.github.com/zen\n```\n\nЗапросы без заголовка `X-GitHub-Api-Version` по умолчанию будут использовать версию `2022-11-28`.\n\nЕсли вы укажете версию API, которая больше не поддерживается, вы получите `410 Gone` ответ.\n\n## Обновление до новой версии API\n\nПеред обновлением до новой версии REST API необходимо прочитать журнал изменений критических изменений для новой версии API, чтобы понять, какие критические изменения включены и узнать больше о том, как обновить эту версию API. Дополнительные сведения см. в разделе [Критические изменения](/ru/rest/about-the-rest-api/breaking-changes).\n\nКогда вы обновляете интеграцию, чтобы указать новую версию API в заголовке `X-GitHub-Api-Version`, вам также нужно внести необходимые изменения для работы с новой версией API.\n\nПосле обновления интеграции проверьте интеграцию, чтобы убедиться, что она работает с новой версией API.\n\n## Версия API Закрытие\n\nВерсии API поддерживаются в течение 24 месяцев после выхода новой версии API.\n\nХотя версия находится в окне поддержки, но приближается  Закрытие, GitHub включает следующие заголовки в ответах API, чтобы помочь вам подготовиться к миграции:\n\n* `Deprecation` — Дата, когда версия API будет Закрытиеотформатирована как HTTP-дата согласно [RFC 7231](https://tools.ietf.org/html/rfc7231#section-7.1.1.1). Например: `Wed, 27 Nov 2019 14:34:29 GMT`. <!-- markdownlint-disable-line GHD046 -->\n* `Sunset` — Дата, когда версия API будет полностью удалена (Вышел на пенсию), после которой запросы вернут `410 Gone` ответ. Следует [RFC 8594](https://tools.ietf.org/html/rfc8594). Например: `Fri, 27 Nov 2020 14:34:29 GMT`. <!-- markdownlint-disable-line GHD046 -->\n\nПосле окончания окна поддержки:\n\n* Запросы, указывающие Закрытие версию API, получают `410 Gone` ответ.\n* Запросы, которые не указывают версию API по умолчанию для следующей старейшей поддерживаемой версии, а не самой Закрытие версии. Если вы полагаетесь на неверсионные запросы, вы можете наблюдать изменения в поведении, когда старые версии удаляются из поддержки.\n\nДля получения дополнительной информации о миграции на более новую версию API см. [AUTOTITLE.](/ru/rest/about-the-rest-api/breaking-changes)\n\n## Исключения из стандартной версии\n\nВ редких случаях GitHub могут вносить изменения вне обычной частоты версионирования API. Это исключительные вмешательства, которые не изменяют стандартные гарантии версионирования для большинства интеграторов.\n\n### Вопросы безопасности, доступности и надёжности\n\nКритические уязвимости безопасности, риски раскрытия данных или серьёзные проблемы с надёжностью могут требовать изменений вне обычного графика выпуска.\nGitHub может выпустить незапланированную версию API, перепортить исправления поддерживаемых версий или, в редких случаях, внести нерешительное изменение существующей версии для защиты пользователей и целостности платформы.\n\nGitHub Будут сообщать об изменениях через заметки к релизу, журналы изменений и прямое объяснение, что и почему изменилось. По возможности будет предоставлено предварительное уведомление. При необходимости могут быть приняты немедленные меры без предварительного уведомления.\n\n### Сервисы с низким уровнем использования\n\nДля некоторых сервисов с очень низким использованием они GitHub могут устарять функциональность вне стандартного процесса версионирования. В таких случаях GitHub они сообщают о намерении и напрямую свяжутся с затронутыми интеграторами.\n\n## Поддерживаемые версии API\n\nВ настоящее время поддерживаются следующие версии REST API.\n\n| Версия API   | Дата окончания поддержки |\n| ------------ | ------------------------ |\n| `2026-03-10` | Not yet scheduled        |\n| `2022-11-28` | March 10, 2028           |\n\nВы также можете запросить API, чтобы получить все поддерживаемые версии API. Дополнительные сведения см. в разделе [Конечные точки REST API для метаданных](/ru/rest/meta/meta#get-all-api-versions)."}