Flickr API ドキュメント日本語訳 |
flickr.panda.getPhotos
認証
このメソッドには認証は必要ありません。
引数
api_key(Required)- あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
panda_name(Required)- 写真を取得するパンダの名前。 現在は三つのパンダ名が使用できます。:
flickr.panda.getList API メソッドを使用することで、現在の全てのパンダ一覧を取得できます。 extras(Optional)- 追加で取得したい情報があれば、その情報が保存されているフィールドをコンマ区切りで設定します。現時点では、以下のフィールドをサポートしています:
description,license,date_upload,date_taken,owner_name,icon_server,original_format,last_update,geo,tags,machine_tags,o_dims,views,media,path_alias,url_sq,url_t,url_s,url_q,url_m,url_n,url_z,url_c,url_l,url_o per_page(Optional)- 1ページ当たりに出力する写真数。この引数を省略した場合、既定では100が設定されます。設定できる最大値は500です。
page(Optional)- 出力するページのページ番号。この引数が省略された場合、既定では1が設定されます。
サーバからの応答例
<photos interval="60000" lastupdate="1235765058272" total="120" panda="ling ling"> <photo title="Shorebirds at Pillar Point" id="3313428913" secret="2cd3cb44cb" server="3609" farm="4" owner="72442527@N00" ownername="Pat Ulrich" /> <photo title="Battle of the sky" id="3313713993" secret="3f7f51500f" server="3382" farm="4" owner="10459691@N05" ownername="Sven Ericsson" /> </photos>
このAPIメソッドを実行する際には、コードでlastupdate属性とinterval属性を使って新しい写真をリクエストするタイミングを決めてください。 lastupdateは写真一覧が作成された日時をUnixタイムスタンプ形式で表し、intervalはFlickr API が再びポーリングするまでの待ち時間(秒数)です。
エラーコード
1: Required parameter missing.- リクエストにいくつかの必須パラメータが設定されていません。
2: Unknown panda- あなたがリクエストしたパンダはまだ誰も見たことがありません。
100: Invalid API Key- 送信されたAPIキーは無効か、既に失効しています。
105: Service currently unavailable- 要求されたサービスは、一時的に利用できない状態です。
106: Write operation failed- 要求された操作は、一時的な問題のために失敗しました。
111: Format "xxx" not found- 要求された応答形式は見つかりませんでした。
112: Method "xxx" not found- 要求されたメソッドは見つかりませんでした。
114: Invalid SOAP envelope- リクエスト時に送信されたSOAPエンベロープを解析できませんでした。
115: Invalid XML-RPC Method Call- リクエスト時に送信されたXML-RPC ドキュメントを解析できませんでした。
116: Bad URL found- 引数の中に、Flickrに対して有害なURLが含まれています。
API 体験
API 体験 : flickr.panda.getPhotos
注意事項 |