Properly displaying the swagger file public/swagger.yaml can facilitate integrations.
All the endpoints have to be described based on the routers endpoints:
https://github.com/monarc-project/zm-client/blob/master/config/module.config.php
https://github.com/monarc-project/zm-core/blob/master/config/module.config.php
The authorisation steps are also required to be defined in the swagger.