Improved doc for REST parameter roleId

> See https://jira.ez.no/browse/EZP-22162

The documentation doesn't make it clear that the `roleId` parameter  must be a REST ID and not an integer. Also added a paragraph on the REST general doc: https://doc.ez.no/display/EZP/General+REST+usage#GeneralRESTusage-Requestparameters.