Authentication

You can find the API for MQTT: 

https://authentication.eniris.be/docs/#/Authentication/accesstoken

You can find the API for HTTPS: 

https://authentication.mqtt.eniris.be/docs/

Eniris Metadata & Telemetry Query API

https://api.eniris.be/docs/

Telemetry Query API

POST https://neodata-ingress.eniris.be/v1/telemetry
Verplichte query params:

u:  collector name
db: database
rp: retention policy

bv.

https://neodata-ingress.eniris.be/v1/telemetry?u=klantennaam-ingress&db=klantennaam&rp=rp_one_m

[
{
"measurement": "exampleMetrics",
"time": "2023-08-02T10:00:00Z",
"tags": {
"serialNr": "aaaabbbbccccdddd"
},
"fields": {
"maximumProductionPower_W": 2000
}
}
]

Merk op dat de bijgesloten Bearer authorisatie token moet verkregen zijn door in te loggen als een gebruiker die lid is van de "Klantennaam" rol. Anders zal je een code 403 terugkrijgen met een foutmelding.

De server kan enkel antwoorden met codes 204 (succes zonder body), 400 (allerhande formatteringsfouten), 403 (authenticatie probleem of incorrecte permissies), 404 (poging om te schrijven naar een niet gekende namespace), 409 (confict met toegelaten data timerange of opgeslagen veld types) of 422 (interne data type inconsistenties binnen het doorgestuurde bericht).

Collection voor postman

Hieronder is een script te vinden voor postman die helpt bij het afhandelen van de token generatie. (zie bijlage)

Influx via api.postman_collection.json

Access timeseries data

Access a device (building/site)

GET https://api.eniris.be/v1/device?id=37142

To edit a property, use POST: