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.
Blog API
Posts
GET
Get All Blog Posts
http://derek.stegelman.com/blog/api/post
Retrieve a list the list of blog posts. By default you will recieve all of the posts, however, it is advisable to pass the GET paramter of posts=x where x is the number of posts you want.