Incluye un User-Agent header en todas las solicitudes.

Un User-Agent header identifica su aplicación, su número de versión y la plataforma y el lenguaje de programación que está utilizando. Debe incluir un User-Agent header con cada solicitud que envíe a la Selling Partner API. Hacer esto ayuda a Amazon a diagnosticar y solucionar problemas de manera más efectiva, lo que ayuda a mejorar su experiencia al usar el servicio.

Para crear un User-Agent header, comience con el nombre de su aplicación, seguido de una barra inclinada, seguida de la versión de la aplicación, seguida de un espacio, un paréntesis de apertura, el par de nombre/valor del idioma y un paréntesis de cierre. El parámetro Idioma es un atributo obligatorio, pero puede agregar atributos adicionales separados por punto y coma.

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

AppId/AppVersionId (Language=LanguageNameAndOptionallyVersion)

El siguiente es un ejemplo de un User-Agent header que podría usar un developer de aplicaciones:

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

Si es un gran selling partner que se está integrando a través de su propio departamento de TI, considere crear un User-Agent header que contenga el atributo Host, como en el siguiente ejemplo. Esto puede ayudar a un ingeniero de soporte de Amazon a solucionar los problemas de manera más efectiva.

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

Para especificar atributos adicionales, utilice el formato AttributeName=Value;, separando cada par de nombre/valor con un punto y coma. Si necesita usar una barra invertida (), cítelo con otra barra invertida (\). Del mismo modo, comillas 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 ambos paréntesis de cierre ()), y un punto y coma (;) en valores de atributo.

Debido a que el User-Agent header se transmite en cada solicitude es una buena práctica limitar el tamaño del header. La Selling Partner API rechazará un User-Agent header si tiene más de 500 caracteres.