Reworked rest api mapping docs.

Made it generally more consistent.
Fixed a formatting issue.

Adding the bit of text between the list and the full spec convinces github to make the summary a code block, which is what was intended.
The {h,}nic in {connect,detach}_network is now part of the url.

Previously it was passed in as part of the body.
Merge branch 'rest-api-docs' into project_deploy

Conflicts:
	docs/rest_api.md