Clojurians Log v2
malli 2026-02-04
Which version of JSON Schema specification does malli.json-schema namespace conform to?
There's a few options available: https://json-schema.org/specification
The reason I'm asking is that my consumers will expect OpenAPI 3.x compatible schema, and that explicitly means https://json-schema.org/draft/2020-12 variant which I'm currently assuming it is, I'd just want some kind of confirmation that yes, this indeed is the target.
Reitit promises to generate OpenAPI v3.1 currently, so yes, JSON Schema should be 2020-12. I don't know if we have been particularly attentive about JSON Schema changes.
https://github.com/metosin/malli/pull/1151 Seems like original impl was done before that version, but there seems to have been only one fix mentioning 2020-12
I agree with Juho: our intention is to output OpenAPI 3.1 on the reitit level, and everything not according to that is a bug. That said, we haven't done rigorous validation of the generated json-schema.
The reitit tests do validate generated openapi docs against openapi validators, but I'm not quite sure how much json-schema validation they do.
We could probably add a mention about JSON Schema version on Malli impl ns, and if someone finds bugs regarding the targetted version we'll be sure to check those.
Adding json-schema validation to the malli test suite would make a lot of sense.
I'll note down an issue about this.
I'd appreciate the explicit mention highly 👍 It's the kind of thing I can finger-point the "But are you reeeaallly compatible?" kind of nags towards 🙂