restapi: add documentation, re #4119

git-svn-id: svn://develop.studip.de/studip/trunk@29156 c5b85792-5220-0410-ad23-ed5b6b8ad999