tech module

November 18, 2025 ยท View on GitHub

home

modules

tech module

technical functions of the API, also used in dataspaces

GET /capabilities -> capabilitiesResponse

data spaces capabilities check
data space compliancy
Parameters
NameInTypeRequiredDescription
date_timequerystringDate time for which the information is requested. If provided the result becomes final and therefore MUST be cacheable.
Responses
CodeContent typeTypeDescription
200application/jsoncapabilitiesResponsethe capabilities of an API, see also https://dev.ishare.eu/ishare-satellite-role/capabilities

POST /connect/token accessTokenRequest -> accessTokenResponse

Request an access token
request an JWT token to use in a dataspace context
Request Body
{
  "grant_type": "string",
  "scope": "string",
  "client_id": "string",
  "client_assertion_type": "string",
  "client_assertion": "string"
}
Responses
CodeContent typeTypeDescription
200application/jsonaccessTokenResponsein case of a valid request, a accessTokenResponse

GET /health

is the API up and running?
This is a healthcheck ENDPOINT
Responses
CodeContent typeTypeDescription

POST /oauth/token

Token Endpoint
This endpoint is used to obtain an access token and optionally an ID token through different OAuth 2.0 grant types, including Client Credentials Flow. Whenever the mTLS flow is taken, the properties will be ignored, and the access token will be generated based on the credentials in the certificate (O or CN).
Request Body
Responses
CodeContent typeTypeDescription