Inclure un en-tête User-Agent dans toutes les demandes
Inclure un en-tête User-Agent dans toutes les demandes
Un en-tête User-Agent identifie votre application, son numéro de version, ainsi que la plateforme et le langage de programmation que vous utilisez. Vous devez inclure un en-tête User-Agent dans chaque requête que vous soumettez à l'API partenaire de vente. Cela permettra à Amazon de diagnostiquer et de résoudre les problèmes de manière plus efficace, contribuant ainsi à améliorer votre expérience d'utilisation du service.
Pour créer un en-tête User-Agent, commencez par le nom de votre application, suivi d'une barre oblique, suivi de la version de l'application, suivi d'une espace, d'une parenthèse ouvrante, de la paire nom/valeur de la langue et d'une parenthèse fermante. Le paramètre Language est un attribut obligatoire, mais vous pouvez ajouter des attributs supplémentaires séparés par des points-virgules.
Le pseudocode suivant illustre un en-tête User-Agent minimalement acceptable :
AppId/AppVersionId (Language=LanguageNameAndOptionallyVersion)
Voici un exemple d'en-tête User-Agent qui peut être utilisé par un développeur d'applications :
My Selling Tool/2.0 (Language=Java/1.8.0.221; Platform=Windows/10)
Si vous êtes un partenaire de vente important qui s'intègre par l'intermédiaire de son propre service informatique, envisagez de créer un en-tête User-Agent contenant l'attribut Host, comme dans l'exemple suivant. Vous aiderez ainsi l'ingénieur du service d'assistance d'Amazon à résoudre les problèmes plus efficacement.
MyCompanyName/build1611 (Language=Perl; Host=jane.desktop.example.com)
Pour spécifier des attributs supplémentaires, utilisez le format NomAttibut=Valeur ; en séparant chaque paire nom/valeur par un point-virgule. Si vous devez utiliser une barre oblique inverse (\), faites-la précéder d'une autre barre oblique inverse (\\). Faites de même pour intégrer une barre oblique dans le nom de l'application (\/), une parenthèse ouvrante dans la version de l'application (\ (), un signe égal dans le nom de l'attribut (\ =) ou une parenthèse fermante (\)) et un point-virgule (\ ;) dans les valeurs d'attribut.
L'en-tête User-Agent étant transmis dans chaque requête, il est recommandé d'en limiter la taille. L'API partenaire de vente rejettera un en-tête User-Agent s'il comporte plus de 500 caractères.
Updated 8 months ago