APIs e Microsserviços

27 jan, 2017

Especificação OpenAPI chega à versão 3.0

Publicidade

A Open API Initiative anunciou o preview da OpenAPI 3.0 com um Draft implementer agendado para o final de fevereiro.

A nova especificação OpenAPI 3.0 vem com as seguintes melhorias:

  • A estrutura geral da especificação foi refatorada para melhor reutilização, como mostrado na imagem abaixo.
  • O esquema JSON inclui suporte para oneOf, anyOf e not
  • Os parâmetros agora podem usar esquema
  • Entraram parâmetros de cookies, saíram parâmetros de dataForm
  • Parâmetros body agora têm sua própria entidade
  • Content type pode ser negociado
  • Pode haver múltiplos hosts
  • As definições de segurança foram simplificadas e melhoradas
  • WebHooks não podem ser descritos através de um mecanismo de callback

A OpenAPI é construída com o Swagger 2.0, que foi doado pela SmartBear para a Linux Foundation com o desejo de construir uma nova organização com um modelo de governança neutra. Google, IBM e Microsoft se interessaram em colaborar e são membros fundadores da Open API Initiative. Uma Technical Developer Community (TDC) foi criada para desenvolver a especificação. A TDC está aberto a qualquer indivíduo que queira contribuir, sem a exigência de adesão.

De acordo com o site InfoQ, depois de um ano de trabalho em “milhares de comentários”, a especificação OpenAPI está perto da versão final sem nenhuma outra grande mudança esperada.