API: Document causes of the 400 Bad Request reply
API: Clarify record creation in example

Also fix it to have required 'priority' field.
Merge pull request #1842 from zeha/httpapi-docs

HTTP API documentation update