capabilitiesInfo object

capabilitiesInfo

required

root level object

Contains information about capabilities. MUST be provided for every participant that provides services within DSGO

publicServices

optional

array of objects

MUST contain a list of public features

identifier

required

string

Identifier of the data service, MUST be unique and defined by the data service provider

title

required

string

Human readable name of the data service, MUST be limited to a maximum of 100 characters

description

optional

string in publicServices

Short description of the data service, MUST be limited to a maximum of 1000 characters

endpointDescription

optional

string in publicServices

URL that provides a description of the service endpoint. Could be for instance a URL to an OpenAPI description, a WSDL document, a a SPARQL Service Description, a DCAT Data Catalog, etc.

endpointUrl

required

string

URL to the data service

tokenEndpoint

optional

string

URL where access token for the feature could be retrieved. This is optional because if title is access token, it is not needed to mention it twice, or if the data service does not require an access token.

status

required

string

Provides information on the status of the service. Must be either active or deprecated

serviceType

required

string

A framework-defined service is required from a framework perspective (including for instance the /capabilities endpoint), a dataspace-defined service is required from a dataspace perspective and a self-defined service is define by the provider of the service (actual data services are part of this category). Allowed values areframework-defined, dataspace-defined, self-defined

version

required

object

Versioning information of the provided service.

compliesWithFrameworkVersions

optional

array of strings

Array of framework versions that the service complies with, at a framework level. If not included, the service is assumed to be compliant with the latest version.

compliesWithDataspaceVersions

optional

array of strings in version

Array of dataspace versions that the service complies with, at a dataspace level. If not included, the service is assumed to be compliant with the latest version.

capabilityVersion

required

array of strings

Version of the provided data service. Not related to the version numbering of the framework or dataspace.

methods

optional

array of strings

Array of HTTP methods supported by the endpoint, for example:GET, POST, UPDATE, DELETE, etc.

aal*

optional

string

Authentication Assurance Levels defined for the data service. Allowed values are QSeal , adSeal, ClientPassword. (see also Betrouwbaarheidsniveaus)

conformsTo*

optional

array of strings

MUST contain a (reference to) (one or more) recognised standard to indicate ontologies, semantics, schemes to which the resource in the data service conforms. In order to be machine-readable, this MUST contain an array of URLs, if this is not possible, it MAY contain a human-readable description of the standard.

restrictedServices

Optional

Array of objects

MUST contain supported restricted features. The structure and parameters are exactly the same as defined in publicServices above. This object should only be provided to the parties which provided a valid access token. If an access token was not provided or restricted endpoints do not exist, restrictedServices MUST not be returned.