Moeilijkheidsgraad: expert
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.
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 https://onespacewell.atlassian.net/wiki/spaces/KB/pages/4357489010/LoRa+Sensors+and+Gateways#Spacewell-LoRa-devices)
- Eigen platforms: pointgrab, vergesense, xovis, signify
- Generic Endpoint: Custom Device Type ID, zie https://onespacewell.atlassian.net/wiki/spaces/KB/pages/4357490176/Custom+Device+Types#General, meestal voorafgegaan door generic|.
Device ID
Meestal Studio-overzicht/export, soms anders. Controleer altijd de Device Label-URL; zie https://onespacewell.atlassian.net/wiki/spaces/KB/pages/4357488843/Sensor+Management#Device-Info).
Vooral controleren bij:
- Pipe | of dubbele punt : in overzicht-ID
- Generic Endpoint, zie Externe gegevensbronnen)
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.
Dit is een door Workplace samengestelde herkenbare naam. Device Label-URL toont database-ID; zie https://onespacewell.atlassian.net/wiki/spaces/KB/pages/4357488843/Sensor+Management#Device-Info).
B6B662F080F2FEA967F903B8A3D8807B.
URL bevat vergesense|B6B662F080F2FEA967F903B8A3D8807B, juiste prefix en ID.
Niet elke browser toont pipe letterlijk:
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 https://onespacewell.atlassian.net/wiki/spaces/KB/pages/4357488843/Sensor+Management#General. Ook Device Label toont geactiveerde typen.
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 https://onespacewell.atlassian.net/wiki/spaces/KB/pages/4357489010/LoRa+Sensors+and+Gateways#Spacewell-LoRa-devices. Prefix tracknet.
- Overzicht E8-E1-E1-00-01-09-27-25; controleer Device Label-URL, zie https://onespacewell.atlassian.net/wiki/spaces/KB/pages/4357488843/Sensor+Management#Device-Info)
- 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
Bevestigt: Advanced Export Device ID en Channel samenvoegen voor LoRa.
API-resultaat voor tracknet|E8-E1-E1-00-01-09-27-25|pir
Xovis
- Eigen platform, prefix xovis.
- Overzicht 00:6E:02:00:C2:E8-1002 bevat dubbele punten; controleer URL, zie https://onespacewell.atlassian.net/wiki/spaces/KB/pages/4357488843/Sensor+Management#Device-Info)
- URL-prefix/ID: xovis|006E0200C2E8-1002
- Suffix:inenoutvoor in-/uitstroom
Samen: xovis|006E0200C2E8-1002|in en xovis|006E0200C2E8-1002|out
API-resultaat voor xovis|006E0200C2E8-1002|in en xovis|006E0200C2E8-1002|out
Probleemoplossing
Bekijk de aanbevolen werkwijzen in https://onespacewell.atlassian.net/wiki/spaces/KB/pages/4357489151/Rest+API#How-to-use-Workplace-API