updated REST API documentation
added test for JSON response format
fixed reference url; whitespace cleanup
removed some completed tasks