Updated REST API ref.

some minor documentation fixes.

Some improvements to the API reference examples.

Updated API ref docs with improvements.
Merge pull request #468 from willum070/api

Updated API ref docs with improvements.