Categoria
Middleware é o coração do pipeline de requisição-resposta em aplicações Node.js. No Express, middlewares são funções callback que recebem (req, res, next) e controlam o fluxo chamando next() para passar ao próximo middleware. No Fastify, o modelo é baseado em plugins e hooks, onde cada middleware recebe (request, reply) e utiliza reply.send() para encerrar a resposta.
Sistemas modernos frequentemente combinam APIs síncronas (REST, GraphQL) com fluxos assíncronos baseados em eventos. Enquanto o OpenAPI se consolidou como padrão para documentar APIs REST, as arquiteturas orientadas a eventos careciam de um equivalente. Desenvolvedores recorriam a documentação ad hoc, diagramas soltos ou especificações internas inconsistentes. Essa lacuna gerava retrabalho, bugs de integração e dificuldade para novos membros entenderem o fluxo de eventos.
CORS (Cross-Origin Resource Sharing) é um mecanismo de segurança implementado pelos navegadores que permite ou restringe requisições HTTP entre diferentes origens. Uma origem é definida pela combinação de protocolo, domínio e porta. Por exemplo, https://api.exemplo.com e https://app.exemplo.com são origens diferentes.
Em APIs modernas, validar payloads de entrada não é apenas uma boa prática — é uma necessidade crítica de segurança e confiabilidade. Dados malformados podem causar desde erros silenciosos até vulnerabilidades graves como injeção de dados ou quebra de regras de negócio.
O OpenAPI Specification (anteriormente conhecido como Swagger) é um padrão aberto para descrever APIs RESTful de forma estruturada e legível tanto por humanos quanto por máquinas. Sua principal contribuição é permitir a geração automática de documentação interativa e SDKs (Software Development Kits) para múltiplas linguagens de programação, eliminando inconsistências entre a especificação da API e sua implementação.
Em aplicações de alto desempenho, separar operações de leitura e escrita em bancos distintos é uma estratégia comum. O Prisma permite configurar um banco exclusivo para consultas (read replica) e outro para comandos (write master). Isso reduz contenção de recursos e melhora a escalabilidade.
Read replicas são cópias secundárias do banco de dados principal que recebem atualizações contínuas através de replicação assíncrona ou síncrona. Em APIs de alto tráfego, a separação entre operações de leitura (SELECT) e escrita (INSERT/UPDATE/DELETE) é essencial para escalar horizontalmente a capacidade de consulta sem sobrecarregar o nó primário.
Server-Sent Events (SSE) representam uma tecnologia de streaming unidirecional que permite ao servidor enviar dados automaticamente para o cliente através de uma conexão HTTP persistente. Diferentemente dos WebSockets, que oferecem comunicação bidirecional completa, o SSE é otimizado para cenários onde apenas o servidor precisa enviar atualizações contínuas ao cliente.
O streaming de respostas HTTP é uma técnica que permite enviar dados ao cliente de forma incremental, chunk por chunk, sem esperar que todo o payload seja gerado. Diferente do modelo tradicional (buffered), onde o servidor monta a resposta completa em memória antes de enviá-la, o streaming utiliza chunked transfer encoding para transmitir dados assim que disponíveis.
WebSocket é um protocolo de comunicação full-duplex sobre uma única conexão TCP, projetado para aplicações que exigem baixa latência e troca contínua de dados. Diferentemente do HTTP tradicional, onde o cliente faz uma requisição e aguarda a resposta (modelo request-response), o WebSocket permite que servidor e cliente enviem mensagens a qualquer momento, sem necessidade de polling.