Improve API documentation

[Gonza10V]

Improve API documentation as discussed with Chris and Sai.

[timrudge]

Document the how to make requests with queries, plot options, and analysis options (as JSON payloads). List all possible options for each analysis type.