在所有请求中包括一个User-Agent标头

亚马逊SPAPI

一个User-Agent头可以识别你的应用程序,它的版本号,以及你正在使用的平台和编程语言你必须在你提交给销售伙伴API的每个请求中包含一个User-Agent头这样做有助于亚马逊更有效地诊断和解决问题,帮助改善您使用服务的体验

要创建一个User-Agent头,首先是你的应用程序的名称,然后是一个正斜杠,接着是应用程序的版本,然后是一个空格,一个开头的小括号,语言名称/值对,以及一个结束的小括号语言参数是一个必要的属性,但你可以添加额外的属性,用分号分隔

下面的伪代码说明了一个最小可接受的User-Agent头

AppId/AppVersionId (Language=LanguageNameAndOptionallyVersion)
1

下面是一个应用程序开发者可能使用的User-Agent头的例子

我的销售工具/2.0 (语言=Java/1.8.0.221; 平台=Windows/10)
1

如果你是一个大型的销售伙伴,通过自己的IT部门进行整合,可以考虑创建一个包含主机属性的User-Agent头,就像下面的例子一样这可以帮助亚马逊的支持工程师更有效的为你排除故障

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

要指定额外的属性,使用格式AttributeName=Value;,用分号分隔每个名称/值对如果你需要使用反斜杠(\),用另一个反斜杠(\\)来引用它同样,在应用程序名称中引用一个正斜杠(\/),在应用程序版本中引用一个开口括号(\(),在属性名称中引用一个等号(\=),在属性值中同时引用一个结束括号())和一个分号(\😉

因为User-Agent头在每个请求中都会被传送,所以限制头的大小是一个好的做法如果User-Agent头的长度超过500个字符,销售伙伴API将拒绝它