Home > API × PHP > Amazon Web サービスの使い方(2) - RESTリクエストパラメータ

Amazon Web サービスの使い方(2) - RESTリクエストパラメータ

2007-05-18 (金)
API × PHP

本題に入る前に、そもそもRESTリクエストとは何かを知っておく必要があります。

http://www.amazon.co.jp/gp/feature.html?docId=451209

REST(またはXML over HTTP)とは、キーと値のペアをパラメータに指定してAmazon Web サービスを呼び出し、処理を実行させる仕組みのことです。処理に必要なパラメータは、URIの一部として渡されます。Amazon Web サービスは、受け取ったリクエストを処理し、結果を整形式のXMLドキュメントとして返します。

要するに、APIの提供元が指定する形式で、パラメータを付けたURIにアクセスすれば、パラメータ（例えば検索ワードとか）に対する結果をXML形式で受け取ることが出来るという仕組みになっています。

試しに以下のURLにアクセスしてみてください。

「API」というキーワードを含む書籍を検索するリクエスト

（細かいパラメータは後で解説するとして）上記のURLでは、「API」というキーワードを含む書籍を検索するリクエストになります。

処理結果はXML形式で返され、一つの商品情報ごとに Item タグで囲まれ、著者は Author タグ、本の題名は Title タグで囲まれているのが分かるでしょうか？

最終的には、このようにして得られた結果を訪問者が見やすいように整形して表示させるのですが、今回は、リクエストパラメータの説明までに留めておきます。

リクエストパラメータ

以下に、よく使うリクエストパラメータを載せておきます。

パラメータ	値
Service	AWSECommerceService （固定）
AWSAccessKeyId	[Access Key ID]
AssociateTag	[Your Associate ID Here]
Operation	ItemSearch （商品名などで検索） ItemLookup （ItemId などで検索）
Version	2007-02-22 （指定無しの場合は最新Ver）
ResponseGroup	Small （最小限の情報） Medium （中くらいの情報） Large （沢山の情報）他にも細かく取得情報の選択が可能
Keywords	検索ワード
ItemId	ASINコード（Operation=ItemLookup の場合に必要）
SearchIndex	Blended （全ての商品） Books （和書） ForeignBooks （洋書） Electronics （エレクトロニクス） Kitchen （ホーム&キッチン） Music （ミュージック） Classical （クラシック音楽） DVD （DVD） Software （ソフトウェア） VideoGames （ゲーム） Toys （おもちゃ） Hobbies （ホビー） SportingGoods （スポーツ&アウトドア） HealthPersonalCare （ヘルス & ビューティー） Watches （時計）
ItemPage	1～（取得したいページ）
ContentType	text/xml （XML形式で取得） text/html （HTML形式で取得）