Datamesh APIs

The Datamesh gateway supports a number of REST API specifications for accessing data. All API requests must be authorized using include your Datamesh token

Features

All vector datasources are exposed through a WFS3.0 service. This API is full compliant to the OGC Features API specification . The API root is accessible at:

https://gateway.datamesh.oceanum.io/features

API UI and docs are available at https://gateway.datamesh.oceanum.io/features/docs and https://gateway.datamesh.oceanum.io/features/redoc

EDR

All gridded datasources are exposed through the new OGC Environmental Data Retrieval service. This API is full compliant to the OGC EDR API specification but is only partially implemented. The API root is accessible at:

https://gateway.datamesh.oceanum.io/edr

API UI and docs are available at https://gateway.datamesh.oceanum.io/edr/docs and https://gateway.datamesh.oceanum.io/edr/redoc

OceanQL

The OceanQL endpoint provides a way to query for subsets or sections of datasources, including direct download. This API is used by the Datamesh UI and Integration libraries to provide download and subset capability. However, it is also possible to use the API directly by posting OceanQL queries to the API. The API root is at:

https://gateway.datamesh.oceanum.io/oceanql

API UI and docs are available at https://gateway.datamesh.oceanum.io/oceanql/docs and https://gateway.datamesh.oceanum.io/oceanql/redoc

Zarr

All datasets can be accessed using the Zarr specification which provides lazy chunked access to large datasets. The Zarr enpoint is at:

https://gateway.datamesh.oceanum.io/zarr/<datasource_id>

API UI and docs are available at https://gateway.datamesh.oceanum.io/zarr/docs and https://gateway.datamesh.oceanum.io/zarr/redoc

Please note that you need to include your Datamesh token with every request.

The Integration libraries are the easiest way to use the zarr endpoint, as they will facilitate lazy access and computation using community standard tools for operating or chunked datasets.