OpenAPI (Swagger) descreve APIs REST – esquemas, caminhos e autenticação para documentos e codegen.
As especificações YAML/JSON do OpenAPI 3.x orientam a UI do Swagger, SDKs de cliente e testes de contrato. Esquemas de reutilização de componentes; servidores listam URLs base por ambiente.
Mantenha as especificações sincronizadas com a implementação – o desvio quebra os consumidores. Especificações de lint do Tentaco OpenAPI Validator e Mock Generator e amostra JSON localmente.