Qual é a diferença entre OpenAPI e Swagger? Qual versão você usa?
sobes.tech IA
Resposta da IA
OpenAPI é uma especificação para descrever APIs RESTful, que permite padronizar a descrição de interfaces de serviços web. Swagger, por outro lado, foi inicialmente uma ferramenta e um ecossistema para trabalhar com APIs, incluindo geração de documentação, SDKs de cliente e stubs de servidor.
Em 2016, a especificação Swagger foi renomeada para OpenAPI Specification (OAS) e transferida para a gestão da Linux Foundation sob a égide da OpenAPI Initiative. Atualmente, OpenAPI é um padrão, e Swagger é um conjunto de ferramentas que suportam esse padrão.
Normalmente, usa-se a última versão estável da OpenAPI Specification, que em 2024 é a OpenAPI 3.1.x, pois suporta uma descrição mais flexível, incluindo compatibilidade total com JSON Schema.
Exemplo de uso do OpenAPI 3.1: