Flickr API ドキュメント日本語訳 |
flickr.photos.recentlyUpdated
最近アップロードされた、もしくは最近編集されたあなたの写真の一覧を取得します。
最近編集されたというのは、写真のメタデータ(タイトル、説明、タグ)が変更されたり、コメントが追加(もしくは単に編集)されたりしたことを指します。
認証
このメソッドには「読み込み」権限の認証が必要です。
引数
api_key(Required)- あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
min_date(Required)- Unixタイムスタンプ形式もしくは英文の日付形式で、抽出する編集日の下限を表したもの
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 page="1" pages="1" perpage="100" total="2"> <photo id="169885459" owner="35034348999@N01" secret="c85114c195" server="46" title="Doubting Michael" ispublic="1" isfriend="0" isfamily="0" lastupdate="1150755888" /> <photo id="85022332" owner="35034348999@N01" secret="23de6de0c0" server="41" title=""Do you think we're allowed to tape stuff to the walls?"" ispublic="1" isfriend="0" isfamily="0" lastupdate="1150564974" /> </photos>
写真は更新された日付のタイムスタンプを基に降順で表示されます。
エラーコード
1: Required argument missing.- 必須引数のいくつか、もしくは全てが設定されていません。
2: Not a valid date- 検証の結果、設定されたdata引数が有効な値ではありませんでした。
95: SSL is required- Flickr APIにはSSLでの接続が必要です。
96: Invalid signature- 送信された署名は無効です。
97: Missing signature- 実行には署名が必要ですが、署名が送信されていませんでした。
98: Login failed / Invalid auth token- 送信されたログイン情報や認証トークンが無効です。
99: User not logged in / Insufficient permissions- このメソッドの実行にはユーザー認証が必要ですが、ユーザがログインしていないか、認証メソッドを実行するのに必要な権限がありません。
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.photos.recentlyUpdated
注意事項 |