A OpenAPI Specification, é uma iniciativa para a criação de interfaces usadas para descrever, produzir, consumir e exibir serviços RESTful, existem também ferramentas para gerar código, casos de testes e outros recursos necessários fornecidos pela iniciativa.
O principal argumento para a adoção da OpenAPI Specification é o histórico fundamentado no Swagger que existe a muito tempo dando a credibilidade e a estabilidade necessárias garantida pela grande comunidade e suporte existentes.
Com cenários cada vez mais complexos fazendo uso de APIs, há uma forte demanda por garantir as aplicações em relação a padronização, é a peça que estava faltando para iniciativas como a de Open Banking por exemplo.
Grandes players apoiam diretamente a iniciativa e a OpenAPI pelo que tudo indica veio para ficar, entretanto é sempre importante analisar os possíveis impactos em sistemas existentes, a OpenAPI dá suporte a uma grande quantidade de linguagens, isso significa que sistemas implementados com linguagens específicas podem sofrer grandes impactos, vale uma detida análise antes de qualquer ação mais radical.
A OpenAPI oferece um rico framework entretanto é importante que se atente as boas práticas existentes e destacadas pela iniciativa, para que se possa construir melhores APIs, para mais informações visite www.openapis.org.
Para me conhecer melhor acesse meu site e meu perfil no LinkedIn, fique a vontade para entrar em contato, vamos conversar !!!