Incluir un encabezado User-Agent en todas las solicitudes

Incluir un encabezado User-Agent en todas las solicitudes

Un encabezado User-Agent identifica tu aplicación, su número de versión y la plataforma y el lenguaje de programación que estás utilizando. Debes incluir un encabezado User-Agent en cada solicitud que envíes a la API del colaborador comercial. De esta forma, Amazon puede diagnosticar y solucionar problemas de forma más eficaz, lo que contribuye a mejorar tu experiencia de uso del servicio.

Para crear un encabezado User-Agent, comienza con el nombre de la aplicación, seguido de una barra diagonal, seguido de la versión de la aplicación, seguido de un espacio, un paréntesis de apertura, el par nombre/valor del idioma y un paréntesis de cierre. El parámetro Language es un atributo obligatorio, pero puedes añadir atributos adicionales separados por punto y coma.

El siguiente pseudocódigo ilustra un encabezado User-Agent mínimamente aceptable:

AppId/AppVersionId (Language=LanguageNameAndOptionallyVersion)

El siguiente es un ejemplo de un encabezado User-Agent que podría utilizar un desarrollador de aplicaciones:

My Selling Tool/2.0 (Language=Java/1.8.0.221; Platform=Windows/10)

Si eres un colaborador comercial importante que se está integrando a través de su propio departamento de TI, plantéate la posibilidad de crear un encabezado User-Agent que contenga el atributo Host, como en el siguiente ejemplo. Esto puede ayudar a un ingeniero de asistencia de Amazon a solucionar tus problemas de forma más eficaz.

MyCompanyName/build1611 (Language=Perl; Host=jane.desktop.example.com)

Para especificar atributos adicionales, utiliza el formato AttributeName=Value;, separando cada par de nombre/valor con un punto y coma. Si necesitas usar una barra invertida (\), usa delante otra barra invertida (\\). Del mismo modo, usa una barra diagonal en el nombre de la aplicación (\/), un paréntesis de apertura en la versión de la aplicación (\ (), un signo igual en el nombre del atributo (\ =) y un paréntesis de cierre (\)) y un punto y coma (\;) en los valores de los atributos.

Dado que el encabezado User-Agent se transmite en cada solicitud, lo recomendable es limitar el tamaño del encabezado. La API del colaborador comercial rechazará un encabezado User-Agent si tiene más de 500 caracteres.


¿Te ha ayudado esta página?