HTTPQUERY
Español

TE

Uso

La cabecera TE permite a un cliente comunicar al servidor sus preferencias de codificación de transferencia. El servidor usa esa información para elegir una codificación adecuada para el Transfer-Encoding del cuerpo de la respuesta.

En HTTP/1.1, la codificación de transferencia chunked siempre se admite de forma implícita y no es necesario enumerarla en la cabecera TE. La cabecera cumple principalmente dos funciones: anunciar la compatibilidad con algoritmos de compresión adicionales (gzip, deflate, compress) aplicados en el nivel de transferencia, y señalar la compatibilidad con los campos Trailer.

El valor trailers es especialmente importante. Si el cliente no declara TE: trailers, el servidor no tiene ninguna garantía de que el cliente procese los campos trailer, incluso cuando la respuesta use codificación chunked. Los campos Trailer transportan metadatos como sumas de comprobación o firmas digitales que se añaden después del cuerpo del mensaje.

Cada directiva de codificación admite un valor de calidad (q) opcional comprendido entre 0 y 1, donde los valores más altos expresan una preferencia mayor. Cuando no hay valor de calidad, el servidor considera que la preferencia es 1.

Nota

En HTTP/2 y HTTP/3, el único valor aceptado para la cabecera TE es trailers. Las codificaciones del nivel de transferencia las gestiona la capa de entramado del protocolo.

trailers

La directiva trailers indica que el cliente acepta campos Trailer en una codificación de transferencia chunked. Este valor no participa en la ordenación por valores de calidad.

gzip

La directiva gzip indica que el cliente admite la codificación Lempel-Ziv (LZ77) con un CRC de 32 bits en el nivel de transferencia.

deflate

La directiva deflate indica que el cliente admite datos comprimidos con zlib en el nivel de transferencia.

compress

La directiva compress indica que el cliente admite la compresión Lempel-Ziv-Welch (LZW) en el nivel de transferencia.

q (quality value)

El parámetro q asigna un peso relativo a cada preferencia de codificación. Los valores van de 0 (no aceptable) a 1 (preferencia máxima). El servidor usa los valores de calidad para seleccionar la mejor codificación de transferencia.

Ejemplo

Un cliente anuncia compatibilidad con los campos trailer y con la codificación de transferencia deflate. El valor de calidad 0.5 otorga a deflate una prioridad menor que el valor predeterminado implícito de 1 de las demás codificaciones enumeradas.

TE: trailers, deflate;q=0.5

Un cliente prefiere la codificación de transferencia gzip y también acepta transferencias compress con menor prioridad.

TE: gzip, compress;q=0.7

Un cliente señala únicamente la compatibilidad con trailer. Esta es la forma estándar utilizada con las conexiones HTTP/2.

TE: trailers