Версии и OpenAPI

Разработвайте според изричния договор /api/v1 и документа OpenAPI за изтегляне.

Версия на API

Версия на API: Версията в URL обозначава договора на публичното API.
Издание на Engine: Номерът на Engine в OpenAPI обозначава реализацията, която е експортирала документа; това не е expected_version на ресурса.
Версия на ресурса: Третирайте версиите на бизнес ресурсите като стойности за контрол на едновременни записи и ги вземайте от текущите отговори.

Съхранявайте изтегления договор заедно с тестовете на интеграцията.
При актуализиране проверявайте задължителните полета, допустимите стойности и схемите на отговорите.