HTTP API documentation update

Document causes for `400 Bad Request` replies.
Clarify record creation example.