search

opengeospatial / ogcapi-connected-systems

Public Repository for the Connected Systems SWG
Other
7 stars 6 forks source link

Change API definition example from OpenAPI 3.1 to OpenAPI 3.0.3 #48

Open ghobona opened 2 months ago

ghobona commented 2 months ago

OGC API Standards are expected to target OpenAPI 3.0.

Part 1 of the OGC API - Connected Systems candidate Standard correctly mentions only OpenAPI 3.0.

https://docs.ogc.org/DRAFTS/23-001r0.html

However, the associated API definition yaml file appears to reference OpenAPI 3.1.

https://github.com/opengeospatial/ogcapi-connected-systems/blob/master/api/part1/openapi/openapi-connectedsystems-1.yaml

Please change the API definition example from OpenAPI 3.1 to OpenAPI 3.0.3.

alexrobin commented 2 months ago

We need to use OpenAPI 3.1 so we can import the SensorML schemas. The schema is large so I don't want to duplicate everything using OpenAPI schema flavor...

alexrobin commented 2 months ago

Features has duplicated the entire GeoJSON schema but I don't think this is a scalable approach. We should migrate to OpenAPI 3.1 instead. The tooling has been working fine for me