Terence, your documentation has been a great help for me. Thank you very much for the work you put into creating this.
And your remark "I'd love it if someone could make OpenAPI documentation for this." triggered something. An openapi spec in the making can now be found here https://github.com/kritsel/tado-openapispec-v2.