Ingest api: externe sensor data toevoegen in ZENSIE


Creëren  import checks
De eerste stap is het creëren van import checks. Een import check bevat alle data van een sensor en creëert een api pad waar waardes naartoe verzonden kunnen worden. Import checks kunnen aangemaakt worden door te navieren naar de checks pagina in het dashboard. Rechts onder kan de plus knop aangeklikt worden om een nieuwe sensor toe te voegen. Hierna kunnen we op de external sensor optie klikken.

We vullen de naam in, selecteren de sensor type en klikken op create.

Sensor types
Sensor types bevatten alle informatie over hoe data weergegeven wordt. Een sensor type bevat informatie zoals de metriek + eenheid (Temperatuur = ºC), data types en verwachte json waardes. Als er een nieuwe sensor types toegevoegd moet worden, stuur ons een bericht.

Data versturen naar een import check

De laatste stap is het versturen van de data naar de api. Nadat de check is opgeslagen zien we de settings pagina. Hier zien we het pad met voorbeeld data.

We kunnen een post doen naar:

https://api.30mhz.com/api/ingest/organization/www.30mhz.com

 

Met deze waardes (dit verandert aan de hand van de import check en sensor type):

[ 
  { 
  "checkId": "import_check_id", 
  "timestamp": "long (seconds-since-the-epoch)", 
  "data": 
    {
      "temp": "double", 
      "hum": "double" 
    }, 
  "status": "ok || fail", 
  "error": "custom error text message" 
  } 
]

 

De waardes zitten binnen een array. Hierdoor kunnen we (optioneel) meerdere sensor data (import checks) in 1 call doen:

[{import_check_1...},{import_check_2...},{etc...}]

 

API Keys
Om de api te gebruiken zijn api keys vereist. Lees hoe api keys in de Authorization header moeten worden toegevoegd.

 

Go back to documentation