{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/uk/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":"/uk/api-reference/appendix/versioning-and-deprecation","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}