すべてのリクエストにUser-Agentヘッダーを含める

すべてのリクエストにuser-agentヘッダーを含める

User-Agentヘッダーは、アプリケーション、そのバージョン番号、使用しているプラットフォームとプログラミング言語を識別します。Selling Partner APIに送信するリクエストにはすべてUser-Agentヘッダーを含める必要があります。これにより、Amazonは問題をより効果的に診断して修正できるようになり、サービスの利用体験の向上につながります。

User-Agentヘッダーを作成するには、アプリケーションの名前で始め、その後ろにフォワードスラッシュ、アプリケーションのバージョン、スペース、開き括弧、言語名/値のペア、閉じ括弧を続けます。Languageパラメーターは必須の属性ですが、セミコロンで区切ってさらに属性を追加できます。

次の擬似コードは、最低限許容可能なUser-Agentヘッダーを示しています。

AppId/AppVersionId (Language=LanguageNameAndOptionallyVersion)

以下は、アプリケーション開発者が使用するできるUser-Agentヘッダーの例です。

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

自社のIT部門を通じて統合を行う大規模な出品パートナーの場合は、次の例のようにHost属性を含むUser-Agentヘッダーを作成することを検討してください。これにより、Amazonサポートエンジニアがより効果的にトラブルシューティングできるようになります。

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

追加の属性を指定するには、AttributeName=Value;という形式を使用し、それぞれの名前/値のペアをセミコロンで区切ります。バックスラッシュ(\)を使用する必要がある場合は、もう一つバックスラッシュを使用してクォートします(\\)。同様に、アプリケーション名の中のフォワードスラッシュ(\/)、アプリケーションバージョンの中の開き括弧(\()、属性名の中の等号(\=)、いずれも閉じ括弧(\))、属性値の中のセミコロン(\;)はそれぞれクォートします。

User-Agentヘッダーはすべてのリクエストで送信されるため、ヘッダーのサイズを制限することが推奨されます。Selling Partner APIは、User-Agentヘッダーが500文字を超えると拒否します。


このページは役に立ちましたか?