Documentação de API: OpenAPI, contrato de interface e evoluindo sem quebrar
OpenAPI (Swagger) é o padrão, mas não basta ter a spec — ela precisa ser a fonte de verdade, gerada do código ou validada contra ele. Entenda versioning de API, deprecation headers e como usar contract testing para não quebrar consumidores.