Camada de API
A camada de API é a porta de entrada do Portal 2. Ela recebe uma chamada HTTP ou GraphQL, valida se o contrato está correto e transforma essa chamada em uma operação que as camadas internas entendem.
Por exemplo, quando uma pessoa envia um formulário, a API verifica o formato dos campos e prepara o contexto de identidade. A regra que decide se a alteração é permitida continua no domínio responsável.
Onde ela fica no fluxo
Responsabilidades
| A camada faz | Por quê |
|---|---|
| Expõe contratos HTTP ou GraphQL. | Consumidores precisam de uma entrada estável. |
| Valida campos, tipos e formatos. | Dados malformados não devem chegar à regra de negócio. |
| Cria contexto de autenticação, autorização e correlação. | As camadas internas precisam de identidade e rastreabilidade. |
| Converte respostas e erros para o protocolo público. | O consumidor recebe uma resposta previsível. |
| Encaminha a operação para o BFF ou caso de uso responsável. | A entrada não concentra comportamento de negócio. |
| Publica a referência do contrato. | Quem integra consegue consultar a rota sem ler o código. |
O que não pertence aqui
Não implemente regras de negócio, acesso direto à persistência ou decisões que dependem do estado de um domínio na camada de API. Também não concentre nela uma resposta desenhada para uma tela específica quando essa composição pertence ao BFF.
Essa fronteira deve ser pequena. Quando uma regra fica aqui por conveniência, outro protocolo ou consumidor precisa replicá-la depois.
Relação com os outros conceitos
- O BFF pode compor a resposta que uma experiência precisa.
- Os domínios validam o negócio e executam o comportamento.
- O Shared fornece recursos técnicos, como logs, autenticação e comunicação.
- Autenticação mostra um exemplo de entrada que protege a sessão do navegador.
Próximos passos
Leia BFF quando a operação servir a uma experiência específica. Leia Domínios antes de decidir onde uma regra deve viver.