すべてのリクエストに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文字を超えると拒否します。
Updated 8 months ago