Albums‎ > ‎

bluemelon.albums.get

retrieves a list of albums in the specified category

Authentication:

Yes (see here for details)

Arguments:

(required) long : categoryid - represents the category (use 0 for the root category)
(optional) string : photocount - the number of photos in the album will be included in the response if this is set to "1"
(optional) string : absoluteurl - the absolute url of the album including "http://" will be included in the response if this is set to "1"
(optional) string : subview_t75 - the url of the cover item in 75x75 will be included in the response if this is set to "1"
(optional) string : subview_t100 - the url of the cover item in 100x100 will be included in the response if this is set to "1"
(optional) string : subview_t100u - the url of the uncropped cover item in 100x100 will be included in the response if this is set to "1"
(optional) string : subview_t150 - the url of the cover item in 150x150 will be included in the response if this is set to "1"
(optional) string : subview_t150u - the url of the uncropped cover item in 150x150 will be included in the response if this is set to "1"
(optional) string : subview_t400300 - the url of the cover item in 400x300 will be included in the response if this is set to "1"
(optional) string : subview_t600450 - the url of the cover item in 600x450 will be included in the response if this is set to "1"
(optional) string : subview_t800600 - the url of the cover item in 800x600 will be included in the response if this is set to "1"
(required) string : publickey - the public key of an application
(required) string : token - the access token

Request Example:

http://www.bluemelon.com/api/rest/{api_sign}/
?method=bluemelon.albums.get&categoryid=0&photocount=1&subview_t150=1&publickey={publickey}&token={token}

Response Example:

<rsp status="ok" onrequest="bluemelon.albums.get" total="0" first="0" batch="0">
<content>
<album id="3454" title=""the Rose's place"*" url="%22therose-splace%22-" date="2009-07-11" accessmode="unlisted" photocount="1">
<subview ext="T150" url="/photo/3454/147663-T150.jpg" width="150" height="150"/>
<description></description>
<tags></tags>
</album>
</content>
</rsp>

Error Codes:

4 - "Missing parameter"
5 - "Invalid parameter"
6 - "Parent category not found"
7 - "Album not found"
12 - "Application not found"
14 - "Invalid accessToken"
16 - "Access token timed out.You must relogin."
17 - "Invalid call signature size"
18 - "Invalid call signature"
20 - "Missing api_sign"
603 - "Account recently expired or deleted"

Comments