assets.details

This function retrieves details about a specific asset.

Parameters

string	api_key	(required) your api key
string	assetid	(required) the assetid of the asset for which to fetch details for

Sample return XML
<?xml version="1.0" encoding="UTF-8"?> <response function="assets.details" status="ok"> <result> <assetid>844D5D3C-1111-1701-BFFC41DDD6B366F6</assetid> <roomid>k5nf6</roomid> <userid>0</userid> <uploadtype>api_image</uploadtype> <added>2009-05-27 14:41:30.0</added> <path>http://www.domain.co.uk//DSC_3058.JPG</path> <clientfilename>Image</clientfilename> <allowdownload>1</allowdownload> <width>100</width> <height>100</height> <url>http://api.muchosmedia.com/.../766B2072-DAEA-BCC6-F95A41C1559D6A25.jpg</url> </result> </response>

Result explanation

string	assetid	Globally unique identifier for this asset
string	roomid	The room associated with this asset
string	userid	The userid of the user that uploaded or generated this image. May be 0 for anonymous users
string	uploadtype	Type of image. Valid values: urlsnaphot snapshot upload api_image
datetime	added	Date and time of when this asset was created or uploaded
string	path	Specifies the actual file name on disk on the Scribblar system
string	clientfilename	This is the name of the file as it originated before being uploaded. This defaults to 'URL Snapshot' for website snapshots and 'Snapshot' for normal whiteboard snapshots. Images added via the API default to 'Image'.
integer	allowdownload	Signals if a file in the assetslist shows a download button for easy downloading. 1=download enabled 0=download disabled
integer	width	The width of the image in pixels.
integer	height	The height of the image in pixels.
string	url	The public URL of the asset.

Error Response
If the function call does not succeed it returns the following error response.

An example of an error response would be the following <?xml version="1.0" encoding="UTF-8"?> <response function="assets.details" status="fail"> <error code="400" message="assetid invalid"/> </response>