The App GardenCreate an App API Documentation Feeds What is the App Garden? |
flickr.collections.getInfo
Returns information for a single collection. Currently can only be called by the collection owner, this may change.
Note that the response values of `iconlarge` and `iconsmall` are defunct and will now return empty mosaic grids. For more information on how to
use the new style of collection mosaics, go here.
Authentication
This method requires authentication with 'read' permission.
Arguments
api_key
(Required)- Your API application key. See here for more details.
collection_id
(Required)- The ID of the collection to fetch information for.
Example Response
<collection id="12-72157594586579649" child_count="6" datecreate="1173812218" iconlarge="https://combo.staticflickr.com/pw/images/collection_default_l.gif" iconsmall="https://combo.staticflickr.com/pw/images/collection_default_s.gif" server="187" secret="36"> <title>All My Photos</title> <description>Photos!</description> <iconphotos> <photo id="14" owner="12@N01" secret="b57ba5c" server="51" farm="1" title="in full cap and gown" ispublic="1" isfriend="0" isfamily="0" /> <photo id="15" owner="12@N01" secret="ba1c2a8" server="58" farm="1" title="Just beyond the door" ispublic="0" isfriend="1" isfamily="0" /> <photo id="17" owner="12@N01" secret="0001969" server="73" farm="1" title="IMG_3787.JPG" ispublic="1" isfriend="0" isfamily="0" /> .... </iconphotos> </collection>
Error Codes
1: Collection not found
- The requested collection could not be found or is not visible to the calling user.
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.