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.
Updated 8 months ago