REST API – Sensorwaarden ophalen

Avatar
Laura CARBO

Moeilijkheidsgraad: expert

Inhoud

Leerdoelen

Na het lezen van dit artikel kun je:

  • GET Sensor Values gebruiken

API voor opgeslagen sensorwaarden van apparaten.

Algemene toegang, tests en probleemonderzoek: REST API.

image-20250123-110431.png

Drie velden: Device ID en From/To Date/Time.

Gebruikstips hieronder.

From/To-datum en tijd

  • Gebruik ISO 8601 zoals 2025-02-16T10:00:00+01:00.
  • From = latest en To leeg voor laatste waarde.

Opmerking

Maximaal één dag, dus tijdspanne hoogstens 24 uur.

Device ID

Gebruik prefix|Device ID|suffixvoor

  • Oorspronkelijke gegevensbron;
  • Unieke databaseidentifier;
  • Exact sensortype.

Info

Test minstens één ID in Workplace API Test wegens mogelijke afwijkingen.

Prefix

Oorspronkelijke bron:

  • LoRa: tracknet, zie Sensoren)
  • Eigen platforms: pointgrab, vergesense, xovis, signify
  • Generic Endpoint: Custom Device Type ID, zie Eigen apparaattypen, meestal voorafgegaan door generic|.

Device ID

Meestal Studio-overzicht/export, soms anders. Controleer altijd de Device Label-URL; zie Sensorbeheer).

Vooral controleren bij:

Info

Browser-URL na https://studio.cobundu.com/…/devices/ geeft prefix/ID, maar | kan %7C zijn.

Voorbeeld-URL

VergeSense-overzicht toont spacewell|Spacewell-Arnhem|Floor 1|1.01.

image-20250123-120822.png

Dit is een door Workplace samengestelde herkenbare naam. Device Label-URL toont database-ID; zie Sensorbeheer).

B6B662F080F2FEA967F903B8A3D8807B.

image-20250123-121514.png

URL bevat vergesense|B6B662F080F2FEA967F903B8A3D8807B, juiste prefix en ID.

Niet elke browser toont pipe letterlijk:

image-20250122-145147.png

Zie https://en.wikipedia.org/wiki/Percent-encoding voor tekencodering.

Suffix

Exact sensortype. Vochtigheid en temperatuur vragen twee aanvragen: prefix|Device ID|humidityen prefix|Device ID|temperature”.

Suffix-tabel:

Workplace-sensortype

API-suffix

Temperatuur

temperature

CO2

co2

Luchtvochtigheid

humidity

VOC

voc

Lichtpercentage

light-pct

Radon

radon

Druk

pressure

Aanwezigheid

pir

Personenaantal

headcount

Instroom

in

Uitstroom

out

Puls

door

Batterij

battery

Controleer Devices Overview/Advanced Export indien onzeker; zie Sensorbeheer. Ook Device Label toont geactiveerde typen.

image-20250123-122742.png
Voorbeeld CO2, Humidity en Temperature in overzicht

Info

Voor LoRa kun je Advanced Export Device ID en Channel samenvoegen.

Vergeet niet:

  • Prefix tracknet
  • Pipe tussen elementen: prefix|Device ID|suffix

Info

Test minstens één ID in Workplace API Test.

Voorbeelden

Browan Motion
  • LoRa, zie Sensoren. Prefix tracknet.
  • Overzicht E8-E1-E1-00-01-09-27-25; controleer Device Label-URL, zie Sensorbeheer)
  • URL-prefix/ID: tracknet|E8-E1-E1-00-01-09-27-25
  • Suffix:pirvoor aanwezigheid

Samen: tracknet|E8-E1-E1-00-01-09-27-25|pir

image-20250123-125131.png

Bevestigt: Advanced Export Device ID en Channel samenvoegen voor LoRa.

image-20250124-103516.png

API-resultaat voor tracknet|E8-E1-E1-00-01-09-27-25|pir

image-20250123-125325.png
Xovis
  • Eigen platform, prefix xovis.
  • Overzicht 00:6E:02:00:C2:E8-1002 bevat dubbele punten; controleer URL, zie Sensorbeheer)
  • URL-prefix/ID: xovis|006E0200C2E8-1002
  • Suffix:inenoutvoor in-/uitstroom

Samen: xovis|006E0200C2E8-1002|in en xovis|006E0200C2E8-1002|out

image-20250122-155256.png

API-resultaat voor xovis|006E0200C2E8-1002|in en xovis|006E0200C2E8-1002|out

image-20250122-155627.png

Probleemoplossing

Bekijk de aanbevolen werkwijzen in REST API

Artikelen in deze sectie