Histórico da Página

...

Uma API não deve ser confundida com um schema. As APIs são interfaces que definem os métodos e caminhos que permitem a comunicação entre dois pontos. Já o schema é uma forma de apresentar dados e seus tipos, permitindo a comunicaçãoposterior transmissão de informações. Definições mais apuradas sobre os schemas podem ser encontradas nesta documentação.

Anteriormente era possível que o schema fosse incluído diretamente na API, porém essa regra foi modificada. Para aprimorar a reusabilidade dos schemas, agora os arquivos JSON devem ser separados em API e Schema. Esse modelo possibilita a utilização do protocolo transactions sem a necessidade de desenvolver uma API, caso essa configuração seja suficiente para suprir a necessidade e interesse do desenvolvedor. Se uma 

Justificar quebra entre dois arquivos distintos. Reusabilidade. Pessoa pode usar o protocolo transactions e se comunicar utilizando apenas schema. Caso outra aplicação necessite, consegue se comunicar através das APIs, seguindo padrão OpenAPI.

...