Report REST API usage for RRC&RPE: how to use collectionURI, viewName

Made some progress:
- creatd a view 'SelfService'
- URL https://.../text?projectURI=_byUWFsWmEeGLPdfJvx2A4w&viewName=SelfService yields nothing: "<?xml version="1.0" encoding="UTF-8"?><ds:dataSource totalCount="0" xmlns:ds="http://jazz.net/xmlns/alm/rm/datasource/v0.1"/>"

- have inspected the HTML element in FireFox and picked up the span tag (containing https://server:9443/rm/views/_hT9bMBnQEeKBkPeKWs5CDQ) and then forming a different URL:
https://.../text?projectURI=_byUWFsWmEeGLPdfJvx2A4w&viewURI=_hT9bMBnQEeKBkPeKWs5CDQ

- this works well, including rich text

QUESTIONS:

• ISN'T THERE AN EASIER WAY TO GET TO THE VIEW URI ?
• WHY IS viewName not working ?
• WHERE IS THE UP TO DATE RRC 4.0 REST API DOCUMENTATION ?

You can also get the viewURI by clicking the pencil icon on the view and select "Show Link", you will get a URL like this:
https://.../rdm/web#action=com.ibm.rdm.web.pages.showProjectDashboard&projectURI=https%3A%2F%2F...%2Fjts%2Fprocess%2Fproject-areas%2F_Ehe6UBlMEeKtmNW8oGGwkg&filterId=_08klghlMEeKtmNW8oGGwkg

from here just grab the filterId parameter and use it in your request

ok got it ... viewURI is same as filterId, because 'views' were previously known as 'saved filters' right ?

correct, this is the easiest way to get the viewURI since RRC 4.0

thank you Edgar