AtomPP を利用したWeb API

連載 [第5回] :

2006年10月12日(木)

そのほかのWeb API-ECSの場合

   ここまでいくつかのWeb APIの標準的な仕様を紹介してきました。しかし、これらの標準的な仕様を利用していないWeb APIもたくさんあります。例えば、広義のRESTとして紹介した、HTTPを利用してXMLをやり取りするだけの「XML on HTTP」とも呼ばれるAPIなどです。

   ここでそのいくつかを紹介しておきましょう。まずは、これまでも例に登場した、Amazonの提供するECSです。これはAmazonの商品情報を取得したり、ショッピングカートを操作できるAPIで、SOAPと（広義の）RESTのインターフェイスが用意されています。

   ECSにおけるRESTインターフェイスでは、エントリポイントとなるURLが用意され、パラメータを全てクエリ文字列としてそこに渡してアクセスすると、結果がXMLで取得できます。例えば、ItemLookupという、ASINコード（Amazonの商品管理コードで、書籍はISBNコードと同じ）で指定した商品の情報を取得するオペレーションを利用した場合のURLと、その結果をリスト21に示します。

リスト21：ECSでのリクエストとレスポンス

（画像をクリックすると別ウィンドウに拡大図を表示します）

このような、URLにパラメータを渡して単純なXMLデータを受け取るタイプのAPIは、アクセスするのも、そしてAPIを公開するのも比較的簡単なので、多く利用されています。

例えばECSへアクセスしてISBNコードから書籍名を取得するためのコードはリスト22のようになるでしょう。

リスト22：ECSで書籍名を取得するサンプル

（画像をクリックすると別ウィンドウに拡大図を表示します）

アクセスの際には必要な情報にあわせてURLを生成してデータを取得し、それを適当なXMLパーサー（ここではXML::Simpleを利用しています）に渡して中身を取り出せばいいだけです。なお、AWSAccessKeyIdに渡す値は20桁のAPI Keyで、あらかじめECSのサイトにアクセスして取得する必要があります。

APIを公開する側にとってもこうしたシンプルな仕様は便利です。なぜならクエリ文字列で渡ってきたパラメータを解析して、それに応じてシンプルなデータを返せばいいからです。例えばXML-RPCのところでも作成した、2つの数字を受け取って足し算をして返すAPIを考えてみます。数字をURL中にnum1とnum2という名前をつけたクエリ文字列として埋め込んで渡してもらい、返すのは以下のようなシンプルなXMLです。


		<?xml version="1.0"?>

		<sumResult>

		  <value>130</value>

		</sumResult>

こんなAPIならリスト23のような簡単なプログラムで実現できます。

リスト23：計算を行うAPIプログラム


		#!/usr/bin/perl

		use strict;

		use warnings;

		use CGI;

		

		my $cgi = CGI->new;

		my $num1 = $cgi->param('num1');

		my $num2 = $cgi->param('num2');

		my $result = $num1 + $num2;

		my $response = <<"END";

		Content-type: text/xml

		

		<?xml version="1.0"?>

		<sumResult>

		  <value>$result</value>

		</sumResult>

		END

		

		print $response;