Difference between revisions of "API Collections Create"
From unroole CMS wiki
Tommy.leung (Talk | contribs) (→URI) |
Tommy.leung (Talk | contribs) (→Response) |
||
| Line 47: | Line 47: | ||
! Description | ! Description | ||
{{:API Response Common}} | {{:API Response Common}} | ||
| + | |- | ||
| + | | id | ||
| + | | integer | ||
| + | | The id of the collection if created successfully. | ||
|} | |} | ||
== Example Response == | == Example Response == | ||
Revision as of 12:28, 4 June 2012
Contents
Summary
Allows for creating a new collection.
URI
https://api.unroole.com/channels/[channel-id]/sorted_playlists
HTTP Method
POST
Required Paramaters
| Paramater | Default | Maximum Length | Accepted Values | Description |
|---|---|---|---|---|
| token | API Persistence Token that identifies this user and its permissions. | |||
| unroole_sorted_playlist[name] | 255 | Name of the collection. |
Optional Paramaters
| Paramater | Default | Maximum Length | Accepted Values | |
|---|---|---|---|---|
| description | MySQL TEXT UTF-8 | The description of the collection. | ||
| active | false | boolean | Make the playlist active or deactivate (dis-regardless of the active/deactivate date). | |
| activate_at | ISO 8061 date | This is required if collection is set to active | ||
| deactivate_at | ISO 8061 date | This is required if collection is set to active and does not disable deactivation | ||
| disable_deactivation | boolean | Disable the deactivation date so that the collection will never expire. | ||
| playlist | false | boolean | Whether the collection is a slideshow | |
| rotation_speed | 0 - 900 | The time between the items in the collection playing as a slideshow (in seconds). Only valid when collection is set to a playlist. |
Response
| Field | Type | Description |
|---|---|---|
| http_status | integer | API Status Code http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html |
| error | Rails default | |
| id | integer | The id of the collection if created successfully. |
