REST API
The API is available to all Buto accounts at no additional cost.
All responses are returned as XML.
Certain functions require XML to be POSTed to them. Please see the individual API pages for more details about its required structure.
Authentication
Each ‘super’ user within your company’s account has a unique API key. This key can be found by clicking on the ‘settings’ link found at the top-right of the control panel.
API requests are authenticated using HTTP Digest. Your API key is your username and any value can be used as your password. For example: Abcdefghijklkmnop:x
You can try the API by using cURL (a command-line tool). Your requests will look something like this – specific examples are found on each page.
curl -H 'Accept: application/xml' -H 'Content-Type: application/xml'
-u Abcdefghijklkmnop:x -d 'request XML' https://api.buto.tv/functionResponse
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 100 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.
