{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ru/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Версионирование и прекращение поддержки API"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"версионирование-и-прекращение-поддержки-api","__idx":0},"children":["Версионирование и прекращение поддержки API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["MoreLogin публикует машиночитаемую версию снимка контракта в ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["info.version"]}," каждого документа OpenAPI. Версия использует календарный формат ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DD"]}," и обозначает контракт документации, а не сегмент версии в URL запроса."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"правила-совместимости","__idx":1},"children":["Правила совместимости"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Изменение"},"children":["Изменение"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Классификация"},"children":["Классификация"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Отражение в документации"},"children":["Отражение в документации"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Добавление необязательного поля запроса или ответа, операции либо значения перечисления"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Аддитивное"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Записать в журнал изменений и обновить все локализованные спецификации"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Уточнение описаний или исправление примера без изменения поведения во время выполнения"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Исправление документации"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Записывать, когда это меняет рекомендации по интеграции"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Сделать необязательное поле обязательным, удалить или переименовать поле либо операцию, сузить допустимые значения, изменить сложившуюся семантику"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ломающее"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["До удаления предоставить путь миграции и отдельно версионированный контракт"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Пометить операцию как ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deprecated: true"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Прекращение поддержки"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Указать замену, дату объявления и планируемую дату удаления после её утверждения"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Клиентам следует игнорировать неизвестные поля ответа и значения перечислений там, где это допускает бизнес-логика. Это снижает поломки от аддитивных релизов."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"метаданные-прекращения-поддержки","__idx":2},"children":["Метаданные прекращения поддержки"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Операция OpenAPI — авторитетное машиночитаемое место. Операция с прекращённой поддержкой должна содержать:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deprecated: true"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["описание с указанием замены или с прямым указанием, что замены нет"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["запись-объявление в журнале изменений API"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["планируемую дату удаления только после утверждения владельцами продукта и шлюза"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Универсальный минимальный срок прекращения поддержки сейчас не гарантируется. Пока дата удаления не опубликована явно, клиентам следует считать операцию поддерживаемой, но планировать переход с неё."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"источник-истины","__idx":3},"children":["Источник истины"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Поведение во время выполнения остаётся авторитетным. OpenAPI, примеры, локализованные копии, манифест поведения операций и журнал изменений проверяются вместе в CI, чтобы не допустить расхождения контракта."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"уровни-проверки","__idx":4},"children":["Уровни проверки"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Успешная проверка качества репозитория подтверждает внутреннюю согласованность файлов OpenAPI, примеров, ссылок, локализованных копий и артефактов управления."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Проверка отображения страниц подтверждает, что выбранные маршруты документации загружаются и отображаются без клиентских ошибок."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Только авторизованный smoke-тест развёрнутого API может подтвердить соответствие производственного поведения опубликованному контракту. Репозиторий не запускает такой тест по умолчанию, поэтому в примечаниях к выпуску нужно отдельно указывать факт производственной проверки."]}]},"headings":[{"value":"Версионирование и прекращение поддержки API","id":"версионирование-и-прекращение-поддержки-api","depth":1},{"value":"Правила совместимости","id":"правила-совместимости","depth":2},{"value":"Метаданные прекращения поддержки","id":"метаданные-прекращения-поддержки","depth":2},{"value":"Источник истины","id":"источник-истины","depth":2},{"value":"Уровни проверки","id":"уровни-проверки","depth":2}],"frontmatter":{"seo":{"title":"Версионирование и прекращение поддержки API"}},"lastModified":"2026-09-05T06:38:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ru/api-reference/appendix/versioning-and-deprecation","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}