The App GardenCreate an App API Documentation Feeds What is the App Garden? |
flickr.photos.getContactsPhotos
Fetch a list of recent photos from the calling users' contacts.
Authentication
This method requires authentication with 'read' permission.
Arguments
api_key(Required)- Your API application key. See here for more details.
count(Optional)- Number of photos to return. Defaults to 10, maximum 50. This is only used if
single_photois not passed. just_friends(Optional)- set as 1 to only show photos from friends and family (excluding regular contacts).
single_photo(Optional)- Only fetch one photo (the latest) per contact, instead of all photos in chronological order.
include_self(Optional)- Set to 1 to include photos from the calling user.
extras(Optional)- A comma-delimited list of extra information to fetch for each returned record. Currently supported fields include: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update. For more information see extras under flickr.photos.search.
Example Response
<photos> <photo id="2801" owner="12037949629@N01" secret="123456" server="1" username="Eric is the best" title="grease" /> <photo id="2499" owner="33853651809@N01" secret="123456" server="1" username="cal18" title="36679_o" /> <photo id="2437" owner="12037951898@N01" secret="123456" server="1" username="georgie parker" title="phoenix9_stewart" /> </photos>
Error Codes
95: SSL is required- SSL is required to access the Flickr API.
96: Invalid signature- The passed signature was invalid.
97: Missing signature- The call required signing but no signature was sent.
98: Login failed / Invalid auth token- The login details or auth token passed were invalid.
99: User not logged in / Insufficient permissions- The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
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.