get API documentation working with inputs, outputs and examples

[bbest]

https://api.calcofi.io/ is too confusing for normal user. Provide more guidance on how to use the API functions with documented input arguments, output results and examples of use at https://calcofi.io/docs/api.html.