BT

A sua opinião é importante! Por favor preencha a pesquisa do InfoQ!

Open API Initiative anuncia a especificação 3.0.0 para OpenAPI

| por Shelby Switzer Seguir 0 Seguidores , traduzido por Andrea Mussap Seguir 1 Seguidores em 08 set 2017. Tempo estimado de leitura: 2 minutos |

Para melhorar a experiência das pessoas que acessam o InfoQ Brasil, nós criamos uma série de funcionalidades que te permitem ficar pode dentro das últimas tendências e das novidades de seu interesse, sem que você seja incomodado por coisas irrelevantes. Receba e-mails periódicos e notificações sobre seus tópicos favoritos!

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.

Avalie esse artigo

Relevância
Estilo/Redação

Olá visitante

Você precisa cadastrar-se no InfoQ Brasil ou para enviar comentários. Há muitas vantagens em se cadastrar.

Obtenha o máximo da experiência do InfoQ Brasil.

Dê sua opinião

HTML é permitido: a,b,br,blockquote,i,li,pre,u,ul,p

Receber mensagens dessa discussão
Comentários da comunidade

HTML é permitido: a,b,br,blockquote,i,li,pre,u,ul,p

Receber mensagens dessa discussão

HTML é permitido: a,b,br,blockquote,i,li,pre,u,ul,p

Receber mensagens dessa discussão

Dê sua opinião

Faça seu login para melhorar sua experiência com o InfoQ e ter acesso a funcionalidades exclusivas


Esqueci minha senha

Follow

Siga seus tópicos e editores favoritos

Acompanhe e seja notificados sobre as mais importantes novidades do mundo do desenvolvimento de software.

Like

Mais interação, mais personalização

Crie seu próprio feed de novidades escolhendo os tópicos e pessoas que você gostaria de acompanhar.

Notifications

Fique por dentro das novidades!

Configure as notificações e acompanhe as novidades relacionada a tópicos, conteúdos e pessoas de seu interesse

BT