Skip to main content
Version: V1-Next

Stellio Context Broker - NGSI-LD API

Stellio is an NGSI-LD compliant context broker developed by EGM. NGSI-LD is an Open API and data model specification for context management published by ETSI.

Stellio is composed of 2 business services:

  • The search service is in charge of managing the information context and handling the temporal (and geo-spatial) queries. It is backed by a TimescaleDB database.
  • The subscription service sequence diagram is in charge of managing subscriptions and notifications. It is backed by a TimescaleDB database.

Additionally, the following two components are deployed to run the full broker functionality:

  • An internal API Gateway module that dispatches requests to downstream services
  • A Kafka streaming engine that decouples communication inside the broker

The Stellio API is integrated into the external API Gateway provided by APISIX. The API base path for Stellio is: https://api.<domain>/context/ngsi-ld/

Stellio supports most features of the NGSI-LD specification including temporal access to the full history of managed entities.

info

Note: The standard behaviour of Stellio is to expect tenant names starting with a urn:ngsi-ld:tenant: prefix. We prefix the dataspace names automatically for Stellio, so for external API calls, you can always set the NGSILD-Tenant header without the prefix.
Example: Use ds_open_datainstead of urn:ngsi-ld:tenant:ds_open_data

A full API description is given here: API Walkthrough