OAI/sig-moonwalk

Support SHACL schema as alternative to json-schema

Fak3 opened this issue · 4 comments

Fak3 commented

It would be nice to allow a resource to be linked with SHACL schema. So that API consumers would know a schema to validate data being sent\received. So that tools like swagger-ui would be able to render appropriate human-friendly data descriptions and playground forms validation.

Presumably https://www.w3.org/TR/shacl/? See also the x-oas-draft-alternativeSchema work in OAI/OpenAPI-Specification#1532 which allows this to be supported today.

Fak3 commented

What is the process to add a new alternative schema to this registry: https://spec.openapis.org/registry/alternative-schema/ ?

As you can probably see, the registry you linked to is still in draft state so the data points are all just examples for now.

That said, the proposed process for adding a registry value should be along the lines of the example PR OAI/OpenAPI-Specification#1811 though the github PR template is not yet set up.