Performed changes on api and made adaptions for test-cases

changing api to HAL conformity
adapt test-cases

- [x] test coverage
- [x] finish the code
- [ ] gather feedback for my changes
- [x] submit changes to the documentation


| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | yes
| Tests pass?   | yes
| Fixed tickets | none
| Doc           | [url to doc|none]