Compressão dados API: 9 técnicas para reduzir tráfego

Compressão de dados em APIs é a prática de reduzir o tamanho do payload trafegado entre cliente e servidor, o que corta latência e consumo de banda. Um documento JSON pode encolher até 70% com a técnica certa, como mostra a documentação da MDN. Abaixo, as 9 técnicas mais usadas, ordenadas por impacto prático no dia a dia de quem desenvolve e consome APIs.

1. Gzip (RFC 1952)

O gzip é o padrão universal de compressão HTTP. Ele usa o algoritmo DEFLATE e é suportado por praticamente todos os servidores e clientes. Para textos JSON ou XML, a redução média fica entre 60% e 70%. Basta enviar o header Content-Encoding: gzip.

2. Brotli (RFC 7932)

Desenvolvido pelo Google, o Brotli comprime melhor que o gzip em taxas de 5% a 15% para texto. Ele exige mais CPU no servidor, mas a maioria dos navegadores modernos já o aceita. Use quando a resposta for grande e a latência importar mais que o processamento.

3. Deflate (zlib)

O deflate, muitas vezes confundido com gzip, usa o mesmo algoritmo, mas com wrapper diferente. Ele é menos eficiente que o gzip em compressão de texto, mas pode ser útil em ambientes com restrição de biblioteca. Em APIs REST, o gzip costuma ser a escolha mais segura.

4. Compressão por dicionário (SDCH, Brotli com dicionário)

Essa técnica usa um dicionário pré-compartilhado entre cliente e servidor para substituir strings comuns por códigos curtos. O Brotli com dicionário customizado pode reduzir payloads JSON em até 40% comparado ao gzip, mas exige que ambos os lados tenham o mesmo dicionário.

5. Delta encoding (RFC 3229)

Para APIs que enviam atualizações frequentes, o delta encoding envia apenas a diferença entre a versão anterior e a nova do recurso. Isso reduz drasticamente o tráfego em cenários de sincronização, como listas de contatos ou feeds. Exige lógica extra no cliente para reconstruir o estado.

6. Minificação de JSON (remoção de espaços e chaves redundantes)

Remover espaços, quebras de linha e chaves desnecessárias do JSON reduz o payload em 10% a 20% sem nenhum algoritmo de compressão. É uma técnica simples, mas que não substitui gzip ou Brotli. Combine as duas para máximo ganho.

7. Compressão de cabeçalhos HTTP (HPACK, QPACK)

Em HTTP/2 e HTTP/3, os cabeçalhos são comprimidos com HPACK e QPACK, respectivamente. Isso reduz o overhead de headers repetidos, como cookies e tokens. APIs que fazem muitas chamadas curtas se beneficiam diretamente dessa compressão, que é transparente para o desenvolvedor.

8. Compressão em nível de rede (TLS, QUIC)

Protocolos como TLS 1.3 e QUIC incluem compressão de alguns campos de handshake, mas não comprimem o corpo da resposta. Essa técnica atua na camada de transporte, reduzindo o número de pacotes. É complementar às demais, não substituta.

9. Compressão de conteúdo binário (Protocol Buffers, MessagePack)

Para APIs que trafegam dados binários, como imagens ou vetores, formatos como Protocol Buffers e MessagePack comprimem a estrutura e reduzem o tamanho em até 30% comparado ao JSON. Exigem schema definido e mudam o formato de troca, o que pode quebrar clientes antigos.

Qual escolher: se sua API é REST e o cliente é um navegador, comece com gzip e teste Brotli. Para APIs internas com payloads grandes e frequentes, avalie delta encoding. Se o payload for pequeno e a latência for crítica, a compressão de cabeçalhos do HTTP/2 já resolve. O custo de implementação cresce da técnica 1 para a 9, então priorize o ganho imediato.

FAQ

O que é compressão de dados em API?

É a redução do tamanho dos dados trafegados entre cliente e servidor, usando algoritmos como gzip ou Brotli. Isso diminui o consumo de banda e a latência, melhorando a performance da API sem alterar a lógica de negócio.

Qual a diferença entre gzip e Brotli?

O gzip é mais antigo e universal, enquanto o Brotli comprime melhor texto, com ganhos de 5% a 15%. O Brotli exige mais CPU no servidor e suporte do cliente, mas é preferível quando o payload é grande e a latência é crítica.

Como habilitar compressão em uma API REST?

No servidor, configure o middleware de compressão (como CompressionMiddleware no ASP.NET Core ou compression no Express). Defina o header Content-Encoding e teste com curl ou ferramentas de rede para confirmar que a resposta está comprimida.

Compressão de dados afeta a segurança da API?

Sim, se mal configurada. Ataques como BREACH podem explorar compressão combinada com criptografia para vazar dados. Por isso, evite comprimir respostas que contenham segredos ou tokens em conjunto com TLS sem proteção adicional.

Quando usar delta encoding em vez de gzip?

Use delta encoding quando a API envia atualizações frequentes do mesmo recurso, como listas ou documentos. O gzip comprime a versão inteira, enquanto o delta envia só a diferença, reduzindo drasticamente o tráfego em cenários de sincronização.

Qual técnica de compressão é mais rápida de implementar?

A minificação de JSON, pois basta remover espaços e quebras de linha no payload antes de enviar. Ela não exige configuração de servidor, mas o ganho é menor que o de gzip ou Brotli. Combine a minificação com gzip para o melhor resultado inicial.