Categoria
Bulk operations permitem executar múltiplas operações (create, update, delete) em uma única requisição HTTP, otimizando o throughput e reduzindo a latência de rede. Casos de uso típicos incluem importação de dados em lote, sincronização entre sistemas e atualizações em massa de registros.
CQRS (Command Query Responsibility Segregation) é um padrão arquitetural que separa operações de escrita (comandos) de operações de leitura (consultas). Enquanto comandos alteram estado, consultas apenas retornam dados sem efeitos colaterais.
Em sistemas distribuídos, race conditions ocorrem quando múltiplos processos ou threads concorrentes acessam e modificam um recurso compartilhado sem coordenação adequada, levando a estados inconsistentes. Imagine dois workers processando pagamentos simultaneamente e debitando o mesmo saldo — sem controle, ambos poderiam considerar o saldo suficiente, gerando inconsistência financeira.
Graceful shutdown é o processo de desligar um serviço de forma ordenada, permitindo que todas as operações em andamento sejam concluídas antes da interrupção final. Em sistemas de produção, onde milhares de requisições podem estar sendo processadas simultaneamente, um shutdown abrupto pode causar perda de dados, conexões órfãs e inconsistência de estado.
Idempotência é a propriedade de uma operação que, quando executada múltiplas vezes, produz o mesmo resultado que uma única execução. Em sistemas financeiros, essa característica não é opcional — é uma exigência fundamental para garantir integridade transacional.
A internacionalização (i18n) e a localização (l10n) são conceitos fundamentais para construir APIs que atendam usuários globais. A internacionalização refere-se ao processo de projetar o sistema para suportar múltiplos idiomas e regiões sem exigir alterações no código-fonte. Já a localização é a adaptação concreta do conteúdo para um locale específico, incluindo traduções, formatos de data, moeda e regras culturais.
A paginação baseada em offset, tradicionalmente usada com LIMIT e OFFSET, apresenta problemas críticos em APIs REST que lidam com grandes volumes de dados. Quando novos registros são inseridos entre requisições, o offset se desloca, causando duplicação ou omissão de itens. Além disso, em bancos com milhões de registros, o OFFSET exige que o banco leia e descarte linhas até a posição desejada, degradando severamente a performance.
Rate limiting é uma técnica de controle de tráfego que restringe o número de requisições que um cliente pode fazer a uma API em um intervalo de tempo específico. Em um ecossistema digital onde APIs são a espinha dorsal de aplicações modernas, o rate limiting protege contra abusos intencionais (ataques DDoS, scraping) e não intencionais (bugs em clientes, loops de retry mal configurados). Sem ele, um único cliente mal comportado pode degradar a experiência de todos os outros usuários.
Soft delete é uma técnica onde registros não são fisicamente removidos do banco de dados, mas marcados como "deletados" através de um campo indicador. Em vez de executar um DELETE, realizamos um UPDATE que define um timestamp no campo deleted_at.
O formato multipart/form-data é o padrão da web para enviar arquivos binários combinados com dados textuais em uma única requisição HTTP. Diferente do application/x-www-form-urlencoded, que codifica tudo como pares chave-valor em formato URL, o multipart divide a requisição em partes separadas por um delimitador chamado boundary.