OpenAPI (Swagger) описує REST API — схеми, шляхи та автентифікацію для документів і codegen.
Специфікації OpenAPI 3.x YAML/JSON керують інтерфейсом користувача Swagger, клієнтськими SDK і контрактними тестами. Схеми повторного використання компонентів; сервери перераховують базові URL-адреси для кожного середовища.
Тримайте специфікації в синхронізації з впровадженням — дрейф ламає споживачів. Tentaco OpenAPI Validator і Mock Generator специфікації lint і зразок JSON локально.