Flickr API ドキュメント日本語訳 |
flickr.photos.getInfo
写真についての情報を取得します。このメソッドを実行するユーザーは、写真の参照権限を持っていなければなりません。
認証
このメソッドには認証は必要ありません。
引数
api_key
(Required)- あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
photo_id
(Required)- 情報を取得する写真のID。
secret
(Optional)- 写真の秘密情報。正しい秘密情報が送信されると、権限のチェックは省略されます。知り合いに写真のIDと秘密情報を渡すことで、個人的な写真を'共有'することができます。
サーバからの応答例
<photo id="2733" secret="123456" server="12" isfavorite="0" license="3" rotation="90" originalsecret="1bc09ce34a" originalformat="png"> <owner nsid="12037949754@N01" username="Bees" realname="Cal Henderson" location="Bedford, UK" /> <title>orford_castle_taster</title> <description>hello!</description> <visibility ispublic="1" isfriend="0" isfamily="0" /> <dates posted="1100897479" taken="2004-11-19 12:51:19" takengranularity="0" lastupdate="1093022469" /> <permissions permcomment="3" permaddmeta="2" /> <editability cancomment="1" canaddmeta="1" /> <comments>1</comments> <notes> <note id="313" author="12037949754@N01" authorname="Bees" x="10" y="10" w="50" h="50">foo</note> </notes> <tags> <tag id="1234" author="12037949754@N01" raw="woo yay">wooyay</tag> <tag id="1235" author="12037949754@N01" raw="hoopla">hoopla</tag> </tags> <urls> <url type="photopage">http://www.flickr.com/photos/bees/2733/</url> </urls> </photo>
<permissions>
エレメントは写真の所有者がこのメソッドを実行した場合にのみ取得されます。
isfavorite
属性は、この写真の所有者ではないログインユーザーにとってのみ意味があるものです。
rotation
属性は、現在設定されている時計回りの回転度を表します。これが設定されると、元画像よりも小さい画像が表示されます。
<date>
エレメントのlastupdate
属性は、写真もしくはそれに付けられた何らかのメタデータ(タグやコメントなど)が最後に編集された時間を、unixタイムスタンプ形式で表したものです。
エラーコード
1: Photo not found.
- 設定された写真IDは無効、もしくはメソッドを実行したユーザーはこの写真の参照権限を持っていません。
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.getInfo
注意事項 |