fix wording in json-structure
fix documentation

explain why the HTTP status code 400 will be returned when ?rev=
is included in the request URL
Fix error message

Small typo in the error message. Was ?=rev but should
read ?rev=