Accept-Language

Uso

La cabecera Accept-Language forma parte de la negociación de contenido. El cliente envía una lista ordenada de etiquetas de idioma y el servidor selecciona la mejor traducción disponible del recurso solicitado.

Los navegadores rellenan esta cabecera a partir de la configuración de idioma del sistema operativo. El valor sigue la sintaxis de etiquetas de idioma BCP 47, que admite códigos de idioma principales (en, de, fr) y subetiquetas regionales (en-US, pt-BR, zh-CN). Los valores de calidad ordenan las preferencias cuando se enumeran varios idiomas.

El servidor comunica el idioma del contenido devuelto mediante la cabecera de respuesta Content-Language. Cuando no existe ninguna traducción coincidente, la mayoría de los servidores devuelven el idioma predeterminado en lugar de responder con 406 Not Acceptable, ya que servir el contenido en un idioma alternativo suele ser más útil que devolver un error.

language-tag

Una etiqueta de idioma BCP 47. Una subetiqueta principal como en coincide con cualquier variante regional. Una etiqueta con subetiqueta de región, como en-GB, apunta a una configuración regional concreta.

*

Un comodín que coincide con cualquier idioma no listado previamente.

;q= (valor de calidad)

Un peso entre 0 y 1 que expresa la preferencia relativa. El valor predeterminado es 1.0. Un valor de 0 marca un idioma como no aceptable.

Ejemplo

Un cliente que prefiere el inglés británico, con el inglés genérico como alternativa y el alemán con menor prioridad. El servidor responde con contenido en inglés genérico.

Solicitud

GET / HTTP/1.1
Host: example.com
Accept-Language: en-GB, en;q=0.9, de;q=0.5

Respuesta

HTTP/1.1 200 OK
Content-Language: en

Una solicitud de un navegador configurado en francés, con cualquier idioma como alternativa.

Accept-Language: fr-FR, fr;q=0.9, *;q=0.5

Una lista de preferencias multilingüe que sitúa el español en primer lugar, el portugués en segundo y el inglés en tercero.

Accept-Language: es, pt;q=0.8, en;q=0.6