Hub per sviluppatoriStato dell'APISupporto

Inclusione di un'intestazione User-Agent in tutte le richieste

Inclusione di un'intestazione User-Agent in tutte le richieste

Un'intestazione User-Agent identifica l'applicazione, il suo numero di versione e la piattaforma e il linguaggio di programmazione che stai utilizzando. Devi includere un'intestazione User-Agent in ogni richiesta inviata all'API per i partner di vendita. Ciò aiuta Amazon a diagnosticare e risolvere i problemi in modo più efficace, contribuendo a migliorare la tua esperienza di utilizzo del servizio.

Per creare un'intestazione User-Agent, inizia con il nome dell'applicazione, seguito da una barra in avanti, seguita dalla versione dell'applicazione, seguita da uno spazio, una parentesi aperta, la coppia nome/valore della lingua e una parentesi chiusa. Il parametro Language è un attributo obbligatorio, ma è possibile aggiungere altri attributi separati da punto e virgola.

Il seguente pseudocodice illustra un'intestazione User-Agent minimamente accettabile:

AppId/AppVersionId (Language=LanguageNameAndOptionallyVersion)

Di seguito è riportato un esempio di intestazione User-Agent che potrebbe essere utilizzata da uno sviluppatore di applicazioni:

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

Se sei un partner di vendita di grandi dimensioni che si sta integrando tramite il tuo reparto IT, valuta la possibilità di creare un'intestazione User-Agent che contenga l'attributo Host, come nell'esempio seguente. Questo può aiutare un tecnico dell'assistenza Amazon a risolvere i problemi per te in modo più efficace.

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

Per specificare attributi aggiuntivi, utilizzate il formato AttributeName=value;, separando ogni coppia nome/valore con un punto e virgola. Se devi usare una barra rovesciata (\), citala con un'altra barra rovesciata (\\). Analogamente, citate una barra nel nome dell'applicazione (\/), una parentesi aperta nella versione dell'applicazione (\ (), un segno di uguale nel nome dell'attributo (\ =) e una parentesi chiusa (\)) e un punto e virgola (\;) nei valori degli attributi.

Poiché l'intestazione User-Agent viene trasmessa in ogni richiesta, è buona norma limitare la dimensione dell'intestazione. L'API per i partner di vendita rifiuterà un'intestazione User-Agent se è più lunga di 500 caratteri.


Questa pagina ti è stata utile?