updates the album name, the description, the tags or set the album cover Authentication:
Yes (see here for details)
Arguments:
(required) long : albumid - the id of the album (optional) string : name - the new album name (optional) string : description - the new album description (optional) string : tags - the new album tags (optional) long : coveritemid - the id of the item to be set as the album cover (optional) long : itemsperpage - the number of items per a page for this album ( -1 = My Global Settings; 0 = all; 40; 80; 120; ) (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.update&albumid=1&name=newalbum&publickey={publickey}&token={token}
Response Example:
<rsp status="ok" onrequest="bluemelon.albums.update"> <content> <album id="1" title="newalbum" url="newalbum" date="2008-10-14 00:00:00.0 CEST"/> </content> </rsp>
Error Codes:
4 - "Missing parameter" 5 - "Invalid parameter" 7 - "Album not found" 11 - "Item 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" 28 - "Item has restricted access" 30 - "Title length must be between 1 and 50" 600 - "No write permissions" 601 - "Mismatched parameter in your request" 602 - "No read permissions" 603 - "Account recently expired or deleted" |