I currently want to develop an openHAB binding for OctoPrint, so other people could just enter their API key and the IP address of the OctoPrint instance and have the full API available out-of-the-box.
As part of this effort I read the REST API documentation and was blown away by the quality there seeing as it's completely hand written.
This made me think it might be useful for everybody consuming the API to go one step further and make it machine readable.
So here we come to my question:
Would you accept an OpenAPI definition of the REST API, if I created one?
This would contain:
- A list of all paths with their requirements
- A JSON Schema to validate and document each APIs input and output
- A test suite making sure that this document stays in sync
What this would enable API consumers to do:
What this would enable the octorprint project to do: