Items‎ > ‎

bluemelon.items.getInfo

retrieves the item's detailed information and optionally : statistics, comments, public albums the item is in

Authentication:

Yes (see here for details)

Arguments:

(required) long : itemid - the id of the item
(optional) string : dates - the fileCreatedDate, fileModifiedDate, and uploadedDate will be included in the response if this is set to "1"
(optional) string : location - the geographical location data will be included in the response if this is set to "1"
(optional) string : dimensions - the item dimensions will be included in the response if this is set to "1"
(optional) string : statistics - the item statistics (the number of visitors to have viewed it) will be included in the response if this is set to "1"
[the return value actually depends on item owner's settings for whether to display visitors' counts or not - only the data the settings allow to be displayed are sent]
(optional) string : comments - comments associated with the item will be included in the response if this is set to "1"
(optional) string : albums - the public albums that the item is presently contained within 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.items.getInfo&itemid=878&dates=1&location=1&dimensions=1&albums=1&comments=1&statistics=1
&publickey={publickey}&token={token}

Response Example:

<rsp status="ok" onrequest="bluemelon.items.getinfo">
<content>
<item ownerid="2">
<dates uploaded="2010-01-26 17:43:19" filemodified="" filecreated="2010-01-26 17:43:35"/>
<location lat="" lon="" accuracy=""/>
<dimensions width="2048" height="1536"/>
</item>
<statistics allHits="33" lastMonthHits="26" lastWeekHits="26"/>
<comment id="6" nickName="mirax" userUrl="http://www.smilejoe.com/mirax/" bioItemUrl="/images/avatars/avatarMaleT75.png"
date="Thursday, February 11, 2010 03:57 AM" unread="false" rating="5">
<body>a comment</body>
</comment>
<comment id="8" nickName="A nickname" userUrl="" bioItemUrl="/images/avatars/avatarGuestT75.png"
date="Friday, March 26, 2010 10:02 AM" unread="false" rating="0">
<body>a comment</body>
</comment>
<comment id="9" nickName="A nickname" userUrl="" bioItemUrl="/images/avatars/avatarGuestT75.png"
date="Friday, March 26, 2010 10:04 AM" unread="false" rating="0">
<body>a comment</body>
</comment>
<comment id="34" nickName="A nickname" userUrl="" bioItemUrl="/images/avatars/avatarGuestT75.png"
date="Monday, March 29, 2010 03:19 AM" unread="true" rating="3">
<body>some text</body>
</comment>
<album id="55" title="an album's" url="analbum-s" date="2010-01-26" accessmode="public">
<description>a line of the description
another line of the description
<tags>keyword,keyword,keyword</tags>
</album>
</content>
</rsp>

Error Codes:

4 - "Missing parameter"
5 - "Invalid parameter"
11 - "Item not found"
16 - "Access token timed out.You must relogin."
18 - "Invalid call signature"
403 - "You are not allowed to perform this operation"
601 - "No read permissions"
602 - "No read permissions"
603 - "Account recently expired or deleted"

Comments