Categories‎ > ‎

bluemelon.categories.get

retrieves a list of subcategories for the specified category

Authentication:

Yes (see here for details)

Arguments:

(required) long : categoryid - represents the category for which to retrieve the subcategories (for the root category use the value 0)
(optional) string : absoluteurl - the absolute url of the category 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.categories.get&categoryid=4&
subview_t150=1&absoluteurl=1&publickey={publickey}&token={token}

Response Example:

<rsp status="ok" onrequest="bluemelon.categories.get" total="0" first="0" batch="0">
<content>
<category id="547" parentid="0" title="A category" url="acategory" date="2009-07-12" absoluteurl="http://www.bluemelon.com/xxx/acategory">
<subview/>
</category>
<category id="335" parentid="0" title="AsddsA" url="asddsa" date="2009-04-09" absoluteurl="http://www.bluemelon.com/xxx/asddsa">
<subview ext="T150" url="/photo/categorycover/335/61922-T150.jpg" width="150" height="150"/>
</category>
</content>
</rsp>

Error Codes:

4 - "Missing parameter"
5 - "Invalid parameter"
12 - "Application not found"
14 - "Invalid accessToken"
15 - "Category not found"
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