Difference between revisions of "API Assets Upload"

From unroole CMS wiki
Jump to: navigation, search
(Optional Paramaters)
Line 106: Line 106:
 
| status
 
| status
 
| string
 
| string
| [[API Status Code]]
+
| {{:API_Status_Code}}
 
|-
 
|-
 
| success_files
 
| success_files

Revision as of 15:59, 28 May 2012

Summary

Allows for uploading a new asset.

URI

http://[channel_subdomain]-[account_subdomain].unroole.com/unroole/admin/assets

[channel_subdomain] is optional

HTTP Method

POST

Required Paramaters

Paramater Default Maximum Length Accepted Values Description
token API Persistence Token that identifies this user and its permissions.
asset[asset][] List of files. Not required if asset[video_id][] is specified.
asset[video_id][] List of youtube videos. The unique video id or url provided by youtube. ex: (LADHwoN2LMM, http://www.youtube.com/watch?v=LADHwoN2LMM). Not required if asset[asset][] is specified.

Optional Paramaters

Paramater Default Maximum Length Accepted Values Description
asset[name] Filename with spaces replaced with underscores. 255 characters The name of the asset.
asset[description] ~17000 characters The description of the asset.
asset[tag_list] ∞, but each tag is 255 characters List of comma separated tags (e.g. Ruby, HTML5, css3).
asset[private] 0 1 - Private
0 - Not private
Public accessibility of an asset determines if its links can be shared or bookmarked.
sharable 0 1 - Yes
0 - No
Asset can be shared through the Mobile Briefcase
editable 0 1 - Yes
0 - No
Asset can be opened in other applications through the Mobile Briefcase
printable 0 1 - Yes
0 - No
Asset can be printed through the Mobile Briefcase

Response

Field Type Description
status string
Code Description
200 No errors occurred. Success.
412 Error occurred. Check specific action for details.
406 Access Denied. It may be a result of one of the following:
* The user associated with the API Persistence Token does not have the permission for this action.
* The account-id or channel-id in the url is incorrect.
401 The specified API Persistence Token does not exist in the system.
success_files array of API Asset Fields List of files that were successfully uploaded
failed_files array of files names List of file names that failed to uploaded
error

Example Response