It would be great to support OpenAPI standard: https://swagger.io/docs/specification/basic-structure/ and https://spec.openapis.org/oas/v3.0.3#openapi-specification

Such approach can be very helpful for many cases:
1. Automatic documentation / libraries building
2. Open standard which is used by many many applications and services
3. Possible to track API requests using standard http log from Web-server
4. Less mistakes. For example: retrieve data - GET, update data - PUT, delete data - DELETE HTTP requests