Items‎ > ‎

bluemelon.items.get

retrieves the items in the specified album 

Authentication:

Yes (see here for details)

Arguments:

(required) long : albumid - the id of the album
(optional) string : etag - the etag will be excluded from the response if this is set to a value other than "1" - the etag is included by default
(optional) string : fmd - the fileModifiedDate will be included in the response if this is set to "1"
(optional) string : fcd - the fileCreatedDate will be included in the response if this is set to "1"
(optional) string : accessmode - the accessmode will be included in the response if this is set to "1"
(optional) string : subview_t75 - the cover item url in 75x75 will be included in the response if this is set to "1"
(optional) string : subview_t100 - the url of the item in 100x100 will be included in the response if this is set to "1"
(optional) string : subview_t100u - the url of the uncropped item in 100x100 will be included in the response if this is set to "1"
(optional) string : subview_t150 - the url of the item in 150x150 will be included in the response if this is set to "1"
(optional) string : subview_t150u - the url of the uncropped item in 150x150 will be included in the response if this is set to "1"
(optional) string : subview_t400300 - the url of the item in 400x300 will be included in the response if this is set to "1"
(optional) string : subview_t600450 - the url of the item in 600x450 will be included in the response if this is set to "1"
(optional) string : subview_t800600 - the url of the item in 800x600 will be included in the response if this is set to "1"
(optional) string : originalurl - the original photo url will be included in the response if this is set to "1"
(optional) int : batch - used for paging of items ;  the number of items to be returned, set to 0 (default) to get all items
(optional) int : first - used for paging of items ;  the number of items to skip ( default = -1 (= 0 ) )
(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.items.get&albumid=1&originalurl=1&fcd=1&originalurl=1&fmd=1&batch=2&subview_t150=1&publickey={publickey}&token={token}

Response Example:

<rsp status="ok" onrequest="bluemelon.items.get" total="417" first="-1" batch="2">
<content>
<item id="535677" title="2010-04-26-10h52m00" filename="2010-04-26-10h52m00.jpg" size="595894" version="0"
etag="c36236296e8ad1bbcb8c7b79e05a7f72" filecreateddate="2010-05-10 09:38:23" originalurl="/photo/7365/535677.jpg"
originalwidth="2048" originalheight="1536">
<subview ext="T150" url="/photo/7365/535677-T150.jpg" width="150" height="150"/>
<description></description>
<tags></tags>
</item>
<item id="535682" title="2010-04-26-10h51m44" filename="2010-04-26-10h51m44.jpg" size="548715" version="0"
etag="674f8f70ff7ddf57323e694f88ce2018" filecreateddate="2010-05-10 09:38:11" originalurl="/photo/7365/535682.jpg"
originalwidth="2048" originalheight="1536">
<subview ext="T150" url="/photo/7365/535682-T150.jpg" width="150" height="150"/>
<description></description>
<tags></tags>
</item>
</content>
</rsp>

Error Codes:

4 - "Missing parameter"
5 - "Invalid parameter"
10 - "Folder 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"
602 - "No read permissions"
603 - "Account recently expired or deleted"

Comments