Swagger OpenAPI validator yields an error

[blokhin]

See https://validator.swagger.io/validator/debug?url=https://raw.githubusercontent.com/Materials-Consortia/OPTIMADE/develop/schemas/openapi_schema.json

Sorry if already known.

[ml-evs]

Do you know why it might fail in your link (which contains "debug"), but seems to validate fine in the GUI version (unless I'm missing something)?

https://validator.swagger.io/?url=https://raw.githubusercontent.com/Materials-Consortia/OPTIMADE/master/schemas/openapi_schema.json

EDIT: looks like the GUI version is just for "exploring", so maybe we do have a problem...

[ml-evs]

Just a heads-up that we've fixed this upstream at Materials-Consortia/optimade-python-tools#480

(see e.g. https://validator.swagger.io/validator/debug?url=https://raw.githubusercontent.com/Materials-Consortia/optimade-python-tools/master/openapi/openapi.json).

We should prepare a PR for this repo fairly soon that updates the schema according to our changes since the 1.0 release.

[blokhin]

@ml-evs Matthew, should the main schema be also PR-ed?

[blokhin]

There are still validation errors: https://validator.swagger.io/validator/debug?url=https%3A%2F%2Fraw.githubusercontent.com%2FMaterials-Consortia%2FOPTIMADE%2Fmaster%2Fschemas%2Fopenapi_schema.json

[ml-evs]

These are all fixed on develop (and the schemas are now checked against this URL in the CI), and will be fixed on master when we decide to do a v1.0.1 release (or if we decide to reorganise our branches following #340).

https://validator.swagger.io/validator/debug?url=https%3A%2F%2Fraw.githubusercontent.com%2FMaterials-Consortia%2FOPTIMADE%2Fdevelop%2Fschemas%2Fopenapi_schema.json

[blokhin]

@ml-evs is there any update on that?

PS my motivation is APIs-guru/openapi-directory#722

[ml-evs]

Hi @blokhin, the schemas have been fixed for a while now, we just haven't pushed to master as it is meant to be reserved for releases only. Once #351 is merged the link to master should work fine (still waiting on some reviews of blocking PRs; hopefully by the next workshop we will have 1.0.1...)

[ml-evs]

Closed by the v1.1 release (#365)!