Can we use JSON-LD expansion or flattening APIs to process APIDOCs?

[priyanshunayan]

I'm submitting a

• bug report.
• feature request.

Current Behaviour:

Presently, this module parses the provided APIDOC along with the context. But this can cause inconsistency, as some authors may prefer to not include some properties/definitions in the context and use the full IRI instead. Processing contextless APIDOCs by either expanding them or flattening them can help to bring the APIDOC to a standard format, which can make processing more robust and consistent among different api documentations.

Refs:
Expansion Algorithm: https://www.w3.org/TR/json-ld-api/#expansion-algorithms
Flattening Algorithm: https://www.w3.org/TR/json-ld-api/#flattening-algorithms

Expected Behaviour:

It should be able to parse other APIDOCs also.

Steps to reproduce:

Use other hydra based APIs like http://sources.test.wikibus.org/doc or http://www.markus-lanthaler.com/hydra/event-api/

Do you want to work on this issue?

yes