api.txt - just reformatting

break the very long lines
updated REST API documentation

(fixed typos, better wording)
removed some data from reg-parameters_required.xml example

to make is shorter