Add OpenAPI Compatibility

[pastokes]

Perhaps more aspirational and not necessary, but it might be worth adding compliance with OpenAPI to improve uptake and usability of the API. It looks relatively straightforward and brings with it a lot of useful tools and an exploratory interface.