OGC APIs

This API provides an interface to the Geoserver via the APISIX endpoint /geoserver.

Getting started

To utilize an API via APISIX, you need an account registered on our Keycloak IDM, and an administrator needs to grant you access to a workspace.

For accessing the API with valid credentials, please see How to Get an Access Token.

Workspaces

This API facilitates a generic approach to tenancy through the division of data into so-called dataspaces. These dataspaces are represented as Geoserver workspaces and can only be accessed if your Keycloak-user is a member of the related group and you have been granted a role to read data in this dataspace.

Further readings

The official website provides multiple guides, best practices, and maintains git repositories with use cases and data models.

• WFS_Operations
• WMS_Operations
• WMTS_Operations
• CSW Operations
• WCS Operations
• WPS Operations
• TMS Documentation

Description of the REST API Configuration

Geoserver REST API

Examples

Before the following examples can be executed, an access token must be created. The following guide can help with that: How to Get an Access Token.

Tip: All curls given can be used in tools like Postman by just copying the curl command into the request field.

WMS GetCapabilities

curl --location 'https://api.futr-hub.de/geoserver/wms?service=WMS&version=1.3.0&request=GetCapabilities'\
--header 'Authorization: Bearer <access token>'

WFS DescribeFeatureType

curl --location 'https://api.futr-hub.de/geoserver/ds_open_data/ows?REQUEST=GetFeature&VERSION=1.3.0&SERVICE=wfs&TYPENAMES=ds_open_data:pln_teilraeume_fla'\
--header 'Authorization: Bearer <access token>'