oasis-open / odata-rapid

Rapid - Specification, tools and libraries to support the development and adoption of simple REST-based APIs.
https://rapid.rocks
Apache License 2.0
17 stars 8 forks source link

Should a RAPID service allow to request metadata in the RSDL format? #155

Open chrisspre opened 4 years ago

chrisspre commented 4 years ago

.../$metadata can be requested already in two formats, as JSON and as XML

https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_MetadataDocumentRequest

Once we have a media type for RSDL, it can be requested at /$metadata.

Check if context URLs are problematic with "RSDL metadata"

ralfhandl commented 3 years ago

Yes, it should be possible, need a media type first, see #179

Also it is completely optional to do so.

mikepizzo commented 3 years ago

I would start with a tool that generates RSDL from CSDL, and then see in what scenarios returning RSDL directly from the service would be valuable. As per our positioning, RSDL is intended to be human-readable, and CSDL is the machine-readable.