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.