Get information about an album.
- This method call does not require authentication.
- "read" permission is necessary to access to private docs.
||∗||The ID of the album to get information for.|
Choose your prefered size for the cover:
Access to thumbnail size greater than
800pixels depends on user preferences.
<album album_id="10551" link="http://www.ipernity.com/doc/1/album/10551" title="My very first album" thumbsize="75x"> <description>With my very best videos</description> <dates created_at="1218038768" comment_at="0"/> <count docs="2" visits="0" faves="0" comments="0" family="1" friend="0" ff="0" public="1"/> <cover doc_id="395574" w="75" h="75" url="http://u1.ipernity.com/2/55/74/395574.a1dccd50.75x.jpg"/> <can fave="1" comment="1" add_doc="1"/> <permissions comment="3"/> <you isfave="0" visits="1" last_visit_at="1218039770"/> </album>
Permissions are only returned on an authenticated call by the albums owner.
count.friend, (...) indicates the number of documents visible for each part of the calling user's network.
|1||The album ID is invalid or insufficient permissions to view this album.|
|100||Please add the api_key parameter to this request.|
|101||This API key is invalid or disabled.|
|102||The requested format is invalid. Valid formats are : json, xml, php.|
|103||The requested method is invalid or missing.|
|104||The query signature is missing.|
|105||The query signature is invalid.|
|106||User is not logged. The authentication token is missing.|
|107||The authentication token is invalid.|
|108||The user account is closed or suspended.|
|109||This action is blocked because of a member or a group blocklist restriction|
|110||Insufficient permissions for this method.|
|111||The request came from a remote address not allowed by this application.|
|112||The application has reached its requests quota.|
|113||The client IP has reached a limit. Limits are based on requests per seconds, minutes, hours, ...|
|120||This API method must be called using HTTP POST.|
|121||The SOAP envelope could not be parsed.|
|122||The XML-RPC envelope could not be parsed.|
|130||We only support OAuth version 1.1 and 1.1a|
|131||Some of the OAuth parameters were not sent: %s%|
|132||The timestamp sent is out of ranges. Please check your computer clock is not skewed.|
|133||The OAuth Nonce parameter cannot be used twice.|
|134||The OAuth Timestamp parameter is out of ranges (clock skew) or inferior to the previous timestamp sent.|
|135||The OAuth Signature must be either MD5, HMAC_SHA1 or PLAINTEXT over HTTPS.|
|500||Service general error.|
|501||Service under temporarily maintenance. Thank you for your kind understanding.|
|503||The service is temporarily unavailable. Please try again in a few minutes.|
- 2008-12-01: Method created.