Cool bananas, japhy.

Seriously, this is looking really good. A tiny suggestion, though - in section two, where you are showing examples of the get and post requests, and the stuff with & and $ and + and so on, after each example, you may wish to list exactly what the params are - so it makes a little more sense to the reader.

All in all, this is looking excellent.