OpenAPI 3.1

[m-mohr]

OpenAPI 3.1 is in release candidate phase: https://github.com/OAI/OpenAPI-Specification/releases/tag/3.1.0-rc0

There most important change for us is:

The Schema Object is now fully compliant with JSON Schema draft 2019-09

It allows us to re-use the JSON Schemas of the core STAC repo and get rid of many lines of OpenAPI schemas, it also allows to link to GeoJSON JSON Schema, for example. Related issue it would help with are #29 and #8.

Drawback will be that tooling will take some time to adopt, especially Spectral (for validation) and ReDoc (for documentation) are important.

Related: opengeospatial/ogcapi-features#404

[cholmes]

Putting this on beta.2, since it seems like we should wait till it 3.1.0 final, and hopefully tooling can catch up a bit.

[m-mohr]

Likely even quite a bit later :-)

[philvarner]

Open API 3.1 RC1 just came out, so bumping this past beta.2