According to OGC API Features discussion Support for OpenAPI 3.1 proper support for application schemas has waited OpenAPI version 3.1.
OpenAPI 3.1 has been released in 2021-02-16.
Related to OGC API Features there is proposal for an extension called OGC API - Features - Part n: Schemas. And there is a project page in GitHub for it. However no information about schedule for first draft?
Maybe there's two approaches to publish schemas in distant future:
- schema information included in a OpenAPI 3.1 document published in
/api resource (based on separate conformance class to Open API 3.0 document, that is indicated by the conformance class http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30)?
- schema information published according to future "OGC API - Features - Part n: Schemas" specification in some kind of
returnables resources?
- returnables (default): The schema will specify an object as it is returned at the /collections/{collectionId}/items/{featureId} endpoints of the collection.