全てのレスポンスには、IsValid
要素が含まれています。次に例を示します。
<IsValid>False</IsValid>
このIsValid
要素は、リクエストのいずれかの要素の構文でエラーがあったかどうかと、全ての必須パラメータが指定されていたかどうかを知らせます。例えば、全てのリクエストで必須のOperation
パラメータを省略すると、Product Advertising API は、IsValid
の値として False を設定し、リクエストは処理されません。概して、この種のエラーはすこし複雑です。通常のエラーは、パラメータや値の大文字と小文字が正しくないか、必須パラメータをリクエストに含めなかったことが原因で起こります。例えば、次のリクエストでは、SearchIndex
パラメータが "Searchindex" となっています。
http://ecs.amazonaws.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS アクセスキー ID]
& Operation=ItemSearch
& Keywords=Potter& Searchindex=Books
Product Advertising API は次のエラーを返します。
<Errors>
<Error>
<Code>AWS.MissingParameters</Code>
<Message>Your request is missing required parameters. Required parameters include SearchIndex.
</Message>
</Error>
</Errors>
パラメータ名の "I" が大文字になっていなかったため、Product Advertising API は、リクエストに SearchIndex パラメータが指定されていないと判断します。
このレスポンス例でわかるように、エラーは、エラーを識別するエラーコードと、エラーを説明するエラーメッセージで構成されています。エラーメッセージは、各国の言語で表示されます。
エラーコードとメッセージの詳細については、API リファレンスの エラーコードとメッセージ のセクションをご参照ください。