Версії та OpenAPI

Створюйте інтеграцію на основі явного контракту /api/v1 і доступного для завантаження документа OpenAPI.

Версія API

Версія API: Версія в URL визначає контракт публічного API.
Випуск Engine: Номер випуску Engine в OpenAPI визначає реалізацію, яка експортувала документ; це не expected_version ресурсу.
Версія ресурсу: Версії бізнес-ресурсів використовуються для контролю одночасних змін; отримуйте їх із поточних відповідей.

Зберігайте завантажений контракт разом із тестами інтеграції.
Оновлюючи інтеграцію, перевіряйте обов’язкові поля, допустимі значення переліків і схеми відповідей.