The App GardenCreate an App API Documentation Feeds What is the App Garden? |
flickr.photos.getInfo
Get information about a photo. The calling user must have permission to view the photo.
Authentication
This method does not require authentication.
Arguments
api_key
(Required)- Your API application key. See here for more details.
photo_id
(Required)- The id of the photo to get information for.
secret
(Optional)- The secret for the photo. If the correct secret is passed then permissions checking is skipped. This enables the 'sharing' of individual photos by passing around the id and secret.
Example Response
<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>
The <permissions>
element is only returned for photos owned by the calling user. The isfavorite
attribute only makes sense for logged in users who don't own the photo. The rotation
attribute is the current clockwise rotation, in degrees, by which the smaller image sizes differ from the original image.
The <date>
element's lastupdate
attribute is a Unix timestamp indicating the last time the photo, or any of its metadata (tags, comments, etc.) was modified.
Error Codes
1: Photo not found.
- The photo id was either invalid or was for a photo not viewable by the calling user.
100: Invalid API Key
- The API key passed was not valid or has expired.
105: Service currently unavailable
- The requested service is temporarily unavailable.
106: Write operation failed
- The requested operation failed due to a temporary issue.
111: Format "xxx" not found
- The requested response format was not found.
112: Method "xxx" not found
- The requested method was not found.
114: Invalid SOAP envelope
- The SOAP envelope send in the request could not be parsed.
115: Invalid XML-RPC Method Call
- The XML-RPC request document could not be parsed.
116: Bad URL found
- One or more arguments contained a URL that has been used for abuse on Flickr.