The validator checks the endpoint /doc/api for JSON-LD properties

[manuelfiorelli]

In my understanding of the specs, the /doc/api should only return HTML; therefore, the validator should not check for JSON-LD related stuff such as @type or @id.
The ShowVoc implementation returns a Swagger-UI at that endpoint.

[syphax-bouazzouni]

the /doc/api can return if requested json, the openapi.json documentation, and if HTML is requested the swagger UI.

[manuelfiorelli]

Hi Syphax,

your proposal sounds reasonable, but that's not what the specs currently says:

In fact, there is a potential caveat in your proposal. The Swagger UI is a client-side application that dynamically builds the UI based on the description of the API fetched from a URL: I am unsure how common is to have the same URL serving the specs and the swagger UI though.