Guide for Experimenters

3 IoT-Registry API for advanced experimenters

3.4 Queries

Whereas in the first four points we have covered various features to get data in a more guided way, with the use of SPARQL-based queries we offer the freedom to tailor the request as much as the experimenter wants.

  • Store. This works as a kind of catalogue through which we can offer a number of preconfigured queries to others. At the very same time, everyone is welcome to bring new SPARQL queries to the “store”, by just registering them (through a POST message). This way, non-skilled users could have illustrative examples of how to extract data from the meta-directory and find inspiration to create their own ones.
  • Execute. On the other hand, you can directly execute a query through these endpoints.

Queries IoT Registry Endpoint:

https://platform.fiesta-iot.eu/iot-registry/api/queries/store

Method

Description

Request Body

GET

List all the queries stored

 

GET

Create a new query

Query document, including SPARQL, name, description, etc. More information in 

https://platform.fiesta-iot.eu/iot-registry/api/queries/store/{id}

Method

Description

Request Body

GET

Retrieve an stored query

 

PUT

Update a query

The new query document, including SPARQL, name, description, etc.

DELETE

Delete a stored query

 

https://platform.fiesta-iot.eu/iot-registry/api/queries/execute/{resources/observations/global}

Method

Description

Request Body

POST

Execute a SPARQL query on a specific graph or triple-store.

(resources for Resource descriptions; observations for measurements; global for the whole meta-repository)

 The SPARQL query.

/queries/execute/{resources/observations/global}/id

Method

Description

Request Body

GET

Execute a stored SPARQL query on a specific graph or triple-store.

(resources for Resource descriptions; observations for measurements; global for the whole meta-repository)