json-schema-org / json-schema-spec

The JSON Schema specification
http://json-schema.org/
Other
3.82k stars 266 forks source link

Let's get JSON Schema registered with IANA #1190

Closed cjaccino closed 2 years ago

cjaccino commented 2 years ago

JSON Schema is important and useful today, yet a formal RFC seems like a long way off. It would benefit the community and boost legitimacy and awareness to have JSON Schema registered now.

The IETF's HTTP API working group now tracks a draft for YAML and OpenAPI spec registration. By the name, it's about REST APIs, and I think JSON Schema falls within that scope. YAML and Openapi non-IETF formats that deserve a media type. Would we consider either a similar, separate registration or adding JSON Schema to that document?

While we're at it, should we consider YAML as a viable format for JSON Schema? If so, do we need application/json-schema+yaml or similar?

That draft provides the following. Being able to formally use +yaml creates a dependency on that spec making it to RFC.

It provides:

If JSON Schema were to contribute these, I think the two efforts will have opened the door to much greater cohesion in the API tooling interoperability space, even as JSON Schema continues to evolve.

Thanks!

cjaccino commented 2 years ago

@jdesrosiers it looks like you're way ahead of this. You've already submitted a pull request! Thank you. I'll take the application/json-schema+yaml to the other project.