Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add json schema to model docu and swagger api docu #173

Open
JJ-Author opened this issue Feb 9, 2024 · 1 comment
Open

add json schema to model docu and swagger api docu #173

JJ-Author opened this issue Feb 9, 2024 · 1 comment
Labels
documentation Improvements or additions to documentation feature

Comments

@JJ-Author
Copy link
Collaborator

from @manonthegithub : For json-ld it would be good to have jsonschema docs. then people can generate their own client very easily. Most of languages have json schema libs which allow to generate code and models based on the schema
https://json-schema.org/learn/getting-started-step-by-step#create.

@JJ-Author JJ-Author added documentation Improvements or additions to documentation feature labels Feb 9, 2024
@JJ-Author
Copy link
Collaborator Author

cool idea: that could be another tab additionally to shacl, owl, example.
but also fix the weird output that is shown under "schema" in swagger UI https://dev.databus.dbpedia.org/api/#/Artifact/create-artifact
i saw tools that derived the json schema from an example. so maybe this can be automated. I dont know how good it works for jsonld, but maybe there are also tools who can do it based on owl/shacl for jsonld.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation feature
Projects
None yet
Development

No branches or pull requests

1 participant