Categories‎ > ‎

bluemelon.categories.create

creates a new category with a given name in the root category unless a different category is specified 

Authentication:

Yes (see here for details)

Arguments:

(required) string: categoryname - the name of the new category
(optional) long : categoryid - the id of an existing category where the new category is to be created
(required) string : publickey - the public key of an application
(required) string : token - the access token

Request Example:

http://www.bluemelon.com/api/rest/{api_sing}/
?method=bluemelon.categories.create&categoryname=xxx&publickey={publickey}&token={token}

Response Example:

<rsp status="ok" onrequest="bluemelon.categories.create">
<content>
<category id="340" parentid="0" title="xxx" url="xxx" date="2009-04-09 16:30:39.823 CEST" />
</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"
30 - "Title length must be between 1 and 50"
600 - "No write permissions"
601 - "Mismatched parameter in your request"
603 - "Account recently expired or deleted"

Comments