A Open API Initiative anunciou o lançamento da versão 3.0.0 para especificação de OpenAPIs (OpenAPI Specification - OAS).
O lançamento marca o apogeu de quase dois anos de desenvolvimento e um processo de lançamento de sete meses, começando com um anúncio em janeiro de 2017, seguido do lançamento de um rascunho do implementador em fevereiro, e uma convocação para avaliação pública em junho. O InfoQ já havia anunciado sobre os novos recursos principais do OAS 3.0, que incluem suporte a retorno de chamada e vários hosts, e aprimoramento no suporte ao schema do JSON, bem como novas propriedades, como componentes e links.
A reação da comunidade tem sido esmagadoramente positiva, com várias postagens de parabéns e entusiasmo no Twitter, e crescente suporte à OAS 3.0 em ferramentas de código aberto e comerciais. A versão 3.0 é vista como um marco importante para a especificação e para o projeto, que se enquadra na governança da Fundação Linux.
Ron Ratovsky, membro da Comunidade de Desenvolvedores Técnicos (CDT) da OAS, conversou com a InfoQ sobre o caminho até a versão 3.0 e os desafios que o grupo enfrentou para atualizar a especificação para uma nova versão. O projeto de OAS é gerenciado no Github há quase três anos, e os seis membros do CDT revisaram e fecharam mais de 580 tickets desde setembro de 2014, com mais de 200 ainda abertos.
Falando sobre o grande empreendimento que é organizar, discutir e priorizar solicitações, Ratovsky enfatiza a importância de se considerar as necessidades de uma ampla gama de usuários enquanto se avança no objetivo primário da OAS: padronizar e aperfeiçoar a descrição de REST APIs. Para isso, o suporte a novos protocolos e padrões como o GraphQL estão sendo discutidos, mas ainda não estão no roteiro.
Um novo recurso incluído no OAS 3.0, que procura atender a uma necessidade amplamente discutida na comunidade, é o 'Links object', que alguns chamam de "nod" para hipermídia. Ressaltando que o 'Links object' é uma alternativa estática à hipermídia, que é inerentemente dinâmica e auto-documentada, Ratovsky disse:
A gente pensou em como fazer isso e fornecer uma solução, e para começar, a fizemos estática. Agora, queremos mais comentários sobre o 'Links object' antes de continuarmos o desenvolvimento. Nós pretendemos expandir o recurso e ajudar ainda mais no que se refere à hipermídia.
O CTD está aguardando comentários não apenas para o 'Links object'. Como a maioria dos projetos de código aberto, a OAS depende do apoio e da participação da comunidade. Ratovsky disse que:
Nós realmente dependemos do diálogo e esforços da comunidade - solicitações de recursos, comentários e solicitações de envio. Eu espero ver mais comentários dos Gerentes de Produtos, Engenheiros de Teste, Escritores Técnicos, e qualquer pessoa envolvida no ciclo de vida da API: Como a EOA pode melhorar seu trabalho?
Os usuários podem encontrar informações sobre como se envolver e participar dessa conversa no repositório da OAS no Github. Para os interessados em aprender mais sobre a implementação dos novos recursos, e como migrar do Swagger 2.0 para OAS 3.0, o SmartBear fez uma apresentação em agosto desse ano sobre o assunto e a disponibilizou em seu blog.