O cabeçalho de requisição HTTPAccept-Encoding indica qual codificação de conteúdo, usualmente um algoritmo de compressão, o cliente está apto a entender. Usandonegociação de conteúdo, o servidor seleciona uma das propostas, a utiliza e informa o cliente da escolha feita com o cabeçalho de respostaContent-Encoding.

Até mesmo se o cliente e o servidor suportarem os mesmos algoritmos de compressão, o servidor pode escolher não comprimir o corpo da resposta, se o valor de identidade também é aceitável. Dois casos comuns levam a isso:

• Os dados a serem enviados já estão comprimidos e a segunda compressão não irá deixar os dados menores para serem transmitidos. Isso pode ser o caso com alguns formatos de imagens;
• O servidor está sobrecarregado e não pode suportar a sobrecarga computacional induzida pelas exigências da compressão. Tipicamente, a Microsoft recomenda a não comprimir um corpo de resposta se o servidor utiliza mais do que 80% do seu poder computacional.

Enquanto o valor deidentity, que significa sem codificação, não é explicitamente proibido, por umidentity;q=0 ou um*;q=0 sem qualquer outra atribuição explícita para a identidade, o servidor nunca deve mandar como resposta um erro406Not Acceptable.

Sintaxe

Accept-Encoding: gzipAccept-Encoding: compressAccept-Encoding: deflateAccept-Encoding: brAccept-Encoding: identityAccept-Encoding: *// Múltiplos algoritmos, com pesos baseados na sintaxe dequality value:Accept-Encoding: deflate, gzip;q=1.0, *;q=0.5

Diretivas

gzip

Formato de compressão usando oLempel-Ziv coding (LZ77), com CRC de 32-bits.

compress

Formato de compressão usando o algoritmoLempel-Ziv-Welch (LZW).

deflate

Formato de compressão usando a estruturazlib, com o algoritmo de compressãodeflate.

br

Formato de compressão usando o algoritmo deBrotli.

identity

Indica a identidade da função (i.e. sem compressão, ou sem modificação). Esse valor é sempre considerado como aceitável, mesmo se não estiver presente.

*

Aceita qualquer codificação de conteúdo ainda não listada no cabeçalho. Esse é o valor padrão se o cabeçalho não estiver presente. Isto não significa que qualquer algoritmo é suportado; meramente que nenhuma preferência é expressa.

;q= (valores de peso q)

Qualquer valor é colocado em uma ordem de preferência expressada usando aquality value relativa chamadapeso.

Exemplos

Accept-Encoding: gzipAccept-Encoding: gzip, compress, brAccept-Encoding: br;q=1.0, gzip;q=0.8, *;q=0.1

Especificações

Compatibilidade com navegadores

Veja também

• Negociação de conteúdo HTTP
• Cabeçalho com o resultado do conteúdo de negociação:Content-Encoding
• Outros cabeçalhos similares:TE,Accept,Accept-Charset,Accept-Language