update open api docs

[jduss4]

It seems like a noteworthy task

[karindalziel]

Check comments in issue #17 too

[jduss4]

These days the specification is no longer "swagger," but unfortunately the nice interface we used years ago to build the schema is no longer available. We'll have to investigate new solutions and read the specs in order to update our version.

https://www.openapis.org/

[techgique]

There are some tools and editors documented in their repo: https://github.com/OAI/OpenAPI-Specification/blob/master/IMPLEMENTATIONS.md

[techgique]

Changing our API to be Open API compatible and machine-readable will help make it much easier for people to program access to for other potential front ends and research. I've looked at Open API for work with Open ONI and the structure of the responses is very helpful: https://learn.openapis.org/specification

Also Redoc looks like a very popular tool according to their Tools > Documentation page