[FEATURE] REST API Refactoring

__Tasks:__

- [x] test coverage
- [x] gather feedback for my changes
- [x] submit changes to the documentation
- [ ] ... <add your own tasks>

__Informations:__

| Q             | A
| ------------- | ---
| Tests pass?   | yes
| Fixed tickets | #113 
| Doc           | https://github.com/sulu-cmf/docs/commit/0f63e870422987684e2676855931e2ff24a8130f
@danrot i've added another callbackfunction to this function just today (not pushed yet). it's for getting the $entity's ID. I'm just mentioning this, so we don't forget to include it as well ;)