REST API
The REST API is available to all Buto accounts, including trial accounts. All responses are formatted XML, certain APIs can be passed XML via POST – see the individual API pages for more details on required structure and data types.
Authentication
Each Buto Super user has a unique API key – available from your user preferences screen. API requests are authenticated using HTTP Digest, using your API key as your username and any value as your password, for example: gTgd0Nv43H063Nfv1G4:x
A brief example is shown below using cURL
curl -H 'Accept: application/xml' -H 'Content-Type: application/xml' \
-u gTgd0Nv43H063Nfv1G4:X -d 'request XML (if needed)' http://api.buto.tv
Response
Responses are formatted as Vanilla XML, certain responses will include data from other sections of the API (for use in video players etc) and all responses will use a 200 range status code to indicate success. Errors in the request will result in a 400 range status code and in most cases an error message to detail the problem.
Rate limit
The Buto API has a request limit of 10 requests per second, per IP address, per account. If your application exceeds this limit a ban period of 20 seconds will apply until requests will receive a response.
