Add documentation on new HTTP API
Remove smart quotes
Add Chronos API
Add full stops
Merge pull request #440 from Metaswitch/api-docs

[Reviewer: Ellie] HTTP API docs