SINAP　柿内です。 この連載では写真共有サイトFlickrのAPIを使い、FlickrとFlashを連携させて、FlashへFlickrの画像を読み込んだり、Flashから写真をアップする等のアプリケーションを作る方法をご紹介します。

第１回目はFlickr APIを使用するため、Flickrアカウント及びAPI KEYの取得方法をご紹介しました。今回はFlickr APIの基本的な仕組みをお話しして行きます。

APIの仕組み

APIの仕組みとはいっても、実際は複雑な動作をしている訳ではありません。クライアントからのHTTP Requestに対し、対応したHTTP Responseをユーザーが選択したフォーマットで返すだけです。セッション管理も行われません。またソケット通信の様な永続的な通信もFlickr APIでは用意されてません。１つのリクエストに対し１つのレスポンスを返すという非常にシンプルな仕様になっていますので、理解しやすいでしょう。逆にセッション管理が必要な複雑なアプリケーションを作成するには、自分で用意する必要があります。

APIのリクエストでは必ず次のパラメーターが必要です。

メソッド:APIのなかでどの機能を使うかを選択します。変数名は"method"です。
API KEY:APIへのアクセス権限がある事を証明する、キーとなるものです。変数名は"api_key"です。
その他パラメータ:選択するメソッドによって、必要なパラメータが変わってきます。上記２つは必須ですが、その他パラメータはメソッドにより必須であったり、オプションであったりします。

サポートされているリクエストのフォーマット

Flickr APIではリクエストのフォーマットとして3つサポートされています。

サポートされているレスポンスのフォーマット

Flickr APIではレスポンスのフォーマットとして５つサポートされています。レスポンスのフォーマットはリクエストで指定する事ができます。

APIのテスト

それでは実際にAPIへリクエストを送信して、どんなレスポンスが帰ってくるのか見てみましょう。Flashとの連携ではもちろんFlashからリクエストを送るのですが、まずはブラウザを使ってAPIへの接続テストをしてみます。
今回はメソッドのなかで最も良く使われる、"flickr.photos.search"を使いAPIへ接続します。

この他にもたくさんのパラメータが有りますので、詳しくはFlickr Serviceのページをご覧下さい。

RESTのフォーマット

Flickr APIへRESTのリクエストを送るには下記のURLへアクセスします。

http://api.flickr.com/service/rest/

今回は例として、自分のIDで公開されている写真のリストを取得するとします。
その時のパラメーターは

となります。

これをGETのパラメータに埋め込んだクエリストリングは

http://api.flickr.com/services/rest/?
method=flickr.photos.search&api_key=1234f56cdal&user_id=12345678@N00

となります。これをブラウザのアドレス欄に入力してアクセスすると、下記の様なレスポンスが帰ってきます。

<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
<photos page="1" pages="1" perpage="100" total="1">
<photo id="xxxxxxx" owner="xxxxx469@N0x" secret="80xxxxb3b3" server="xxx" farm="4" title="IMG_1347" ispublic="1" isfriend="0" isfamily="0" />
</photos>
</rsp>

このようにAPIに接続といっても、処理は普通にブラウザでURLにアクセスしているのと変わりません。次回はこのリクエストをFlashから送り、実際にFlash上で写真を表示する方法を説明します。