Asset.CreateRating

Creates a rating to the specified asset.

Parameters and required information

Here's a list of all the parameters you'll need to pass to the Asset.CreateRating method. All of the parameters are required unless otherwise noted.

SessionKey

The session key obtained from User.Login

AssetID

The id of an asset obtained from Workspace.GetAll or Asset.GetDetail

Rating

The rating you want to give the asset, an integer from 0 to 5

Return Codes

Success

Status: success

Returns success if the rating is added correctly.

Status: fail

The call was not successful. Either the session has expired or the XML was not formatted correctly.

Error

5002: Authentication Failure

No active session exists with this session key and developer account id. The user session has expired and the user has to to log on again.

101: The ASSETID attribute is required in the ASSET.CREATERATING function

The ASSETID was not passed along.

505: Restricted - This user is not authorized to access this asset

The user tried to access an asset id that is outside of the list of permitted workspaces.

HTTP POST

<?xml version="1.0" encoding="utf-8"?>  
<request>  
	<sessionkey>string</sessionkey>
	<assetid>string</assetid>
	<rating>integer</rating>     
</request>  

<?xml version="1.0" encoding="utf-8"?>
<mediasilo_response method="Asset.CreateRating" status="success">
</mediasilo_response>