A diferença entre Documentação de API e OpenAPI (muita gente confunde) | #balta

Muita gente acha que Swagger é a documentação da API. Mas não é bem assim. A documentação de verdade é o arquivo que descreve a API: endpoints, métodos, parâmetros, retornos, tipos de dados e versões. E é aí que entra o padrão OpenAPI Specification. O OpenAPI define como essa documentação deve ser escrita, normalmente em JSON ou YAML, permitindo que ferramentas gerem interfaces automaticamente. Ou seja: - A documentação é o arquivo - O OpenAPI é o padrão de escrita - Interfaces como Swagger UI apenas visualizam esse documento