BEAR.ApiDoc generates API documentation from the application.
The documentation generated from the application's method signatures, phpdoc, and JSON Shcema will match the API documentation and the actual application.
This not only saves you the trouble of writing IDL, but also allows you to generate accurate documentation.
composer require bear/api-doc ^1.0
See the API doc documentatiom.