= Zooomr API を使ってみよう = == はじめに == ZooomrはAPIを公開しています。このAPIでユーザーはZooomrの機能を使った様々なツールを作ることができます。 === どんなAPIがあるか === APIの一覧は http://trac.zooomr.com/trac/wiki/ja/ZooomrAPI で公開されています。 * 写真の閲覧/アップロード * 検索 * フォトーク(zipline)の閲覧/アップデートなど、Zooomrのページで使えるほとんどの機能はAPIから使うことが可能です。 Zooomr APIは名前以外は[wiki:ja/ZooomrAPI/Flickr FlickrのAPIによく似ています]。多少の変更でFlickr API用に作られたアプリケーションを移植することができると思います。 == APIの基礎 == === 認証の仕組み === 例えば[http://groups.google.com/group/twitter-development-talk/web/api-documentation TwitterのAPI]を使ったプログラムのほとんどは、使う際にユーザー名とパスワードを入力させます。もし、そのプログラムの作者が悪い人だったら、収集したパスワードを勝手に使われてしまうかもしれません。 Zooomr APIを使ったアプリケーションは、フロブとトークンの仕組みを使って、Zooomrの写真やフォトークのメッセージにアクセスします。この仕組みを使うことで、ユーザーはアプリケーションの作者にIDやパスワードを教えることなしにZooomr APIを使うことができます。ユーザーは、Zooomr APIを使ったアプリケーションが自分の写真やフォトークのメッセージなどへアクセスをするのを許可するか/拒否するかを選ぶことができます。ユーザーがアプリケーションを初めて使うとき、APIはユーザーに対してアクセス許可を求めるZooomrのページを開きます。詳しい仕様は、[wiki:ja/ZooomrAPI/UserAuth ユーザー認証]と[wiki:ja/ZooomrAPI/AuthSpec 認証API]のページを参照してください。 {{{ #!html

}}} ここで「アクセスを許可する」を押すと、そのユーザーのデータをAPIから使うことができるようになります。 {{{ #!html

}}} 自分がどのアプリケーションに対して許可を出しているかは、[http://jp.zooomr.com/account/external_services/api/ 設定/外部サービス/API]のページから確認することができます。 {{{ #!html

}}} === APIキーの取得 === APIを使うには、キーを取得する必要があります。 [http://jp.zooomr.com/services/api/keys/apply/ あなたのAPIキーを適用する]のページから取得することができます。 == 各プログラミング言語用のライブラリ == Ruby, PHP用のライブラリはZooomrユーザーの [http://jp.zooomr.com/bluemonki/ bluemonki]さんが作ってくれました。ありがとうございます。以下から入手できます。 * [http://code.google.com/p/ruby-zooomr-api/ Ruby Zooomr API] * [http://code.google.com/p/php-zooomr-api/ PHP Zooomr API] == プログラム例 == * [wiki:ja/python-api Pythonでの例]