Some updates (hopefully correct!) to the api.md documentation, mostly amplifying the v4 api info.
Merge pull request #53 from rivimey/feature/api-doc-update

Some updates (hopefully correct!) to the api.md documentation