Swagger

Or how easy is it to create the interface documentation?

For a complete documentation of the REST API using Swagger you can just call this URL:

http://localhost/rest/myfirst.nsf/xsp/.xrest/?swagger