Clarify: Send token to discovery endpoints

[m-mohr]

Discovery endpoints (e.g. GET /collections) allow to be requested with and without Bearer Token. Sending the Bearer Tokens with the clients is important once you have it so that private data (e.g. Collections) can be requested. This is important for e.g. exposing Planet data through openEO Platform.

Clarify in the API that clients should send tokens if available. This will likely result in issues for all clients, none supports this yet AFAIK.

[m-mohr]

• [x] Clarify in API spec: #417
• [x] Open Python client issue: https://github.com/Open-EO/openeo-python-client/issues/254, Bearer token is sent
• [x] Open R client issue - R client sends token, but needs to refresh process cache on authentication: https://github.com/Open-EO/openeo-r-client/issues/83
• [x] Open JS client issue - https://github.com/Open-EO/openeo-js-client/issues/55
• [x] Open Web Editor issue - https://github.com/Open-EO/openeo-web-editor/issues/218

[flahn]

The openeo r client already supports this feature for processes and collections. It was requested during openEO to allow internal staff to access the full data catalogue and offer published collections to external users.

[m-mohr]

@flahn This is great news. Is there any caching implemented in the R client that would need to be refreshed on authentication changes?