OpenAPI HTTP spec and client SDK

Hello!

I’ve taken a stab at documenting the mailinabox API using the OpenAPI specification.

While it covers the main endpoints, there’s still a bit of work to do. I do plan on documenting the entire API soon.

As a result of writing out the spec, I have generated and published a typescript-fetch client SDK, which you can find here: https://www.npmjs.com/package/mailinabox-api

(Let me know if you want a client SDK in a different language/framework and i’d be happy to publish it. You can view possible client SDK’s here: https://github.com/OpenAPITools/openapi-generator#overview)

I did this work as I’m developing a custom UI for mailinabox and needed an API client SDK to interact with the API. I will release the UI soon.

I have now documented the remaining endpoints and will be contributing the full API spec to mailinabox, see PR: https://github.com/mail-in-a-box/mailinabox/pull/1804