Overview
Default Template. Can be over-written by making a api_docs/apis.html.
Formats
APIs should return JSON by default with XML as an option, but should be discouraged from use as much as possible. JSON is faster, and more lightweight than XML, and considering that many developers use javascript to consume APIs, what could be better than receiving an object back?
Interface
Long gone are the days of SOAP and other crappy implmenations of http based APIs. Why all the fuss over schemas, methods, and properties, when you can just send an HTTP string with a given header and receive the data you exepect? Seriously, REST is the only method you'll see me using.