stac-api-spec icon indicating copy to clipboard operation
stac-api-spec copied to clipboard
verified publisher icon radiantearth

OpenAPI 3.1

Open m-mohr opened this issue 5 years ago • 3 comments

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: https://github.com/opengeospatial/ogcapi-features/issues/404

m-mohr avatar Jun 24 '20 07:06 m-mohr

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.

cholmes avatar Nov 02 '20 23:11 cholmes

Likely even quite a bit later :-)

m-mohr avatar Nov 02 '20 23:11 m-mohr

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

philvarner avatar May 11 '21 16:05 philvarner