Entertonement API
Overview
With a registered and confirmed account at Entertonement you can upload a clip by submitting a request with the "multipart/form-data" content type.
Clips can be created from mp3 files less than 10MB
Request
Url: http://www.entertonement.com/clips.[format] Method: POST
Form parameters:
Include email and password. See authentication.
name (String) - required
Name of the clip
description (String) - required
Description of the clip
clip (File) - required
The attached mp3 file
category (String) - required
Category the clip belongs to. Use one of the following:
* Sound Effects
* Comedy
* Musicians & Bands
* Business
* Film & Television
* Politics & News
* Sports
* History & Historical People
* General Crackpots
* Comedy
* Musicians & Bands
* Business
* Film & Television
* Politics & News
* Sports
* History & Historical People
* General Crackpots
dialog (String)- optional
Dialog of the clip
collections (String) - optional
A comma-seperated list of collections the clip should belong to - optional. Note that they will not appear in responses until the clip is published.
Response
The clip can fail or be successfully uploaded, or fail to authenticate.
Success
If a clip is successfully created it's id and state are returned. A clip's state can be of 'pending', 'error' or 'published'. When published a clip can be shown by retrieving it's widget representation.
JSON
{
"clip": {
"id": 5000,
"name": "My clip",
"description": "Clip description",
"state": "pending"
}
}XML
<response>
<clip>
<description>This Great Description</description>
<id>5029</id>
<name>The Name of This Great Clip</name>
<state>pending</state>
</clip>
</response>
