Brukerhåndbok for DELTA HTTP API-programvare

postman software logo

Brukerhåndbok for DELTA HTTP API-programvare
logo for postmann programvare

Introduksjon

UNOnext er en multifunksjonssensor. Den gir temperatur (°C/°F), fuktighet (rH%), omgivelseslys (lux), CO2 (ppm), PM2.5 (μg/m3), PM10 (μg/m3). Den avanserte modellen gir valgfritt TVOC (ppb), HCHO (ppb), CO (ppm) og O3 (ppb). Dette dokumentet introduserer bruk av UNOweb HTTP API for å hente sensordataene til UNOnext basert på JSON-format. I tillegg, UNOweb HTTP API gir også glidende gjennomsnittsdata for sensor basert på Taiwan-regulering. Datatettheten er 1 post per 6 minutter når UNOnext er online.
Note. UNOweb HTTP API støtter bare UNOnext som allerede er satt til WiFi og koblet til UNOweb.

Tabell 1 Sensortabell

Sensortype Nøkkel Dataenhet
Temperatur TEMP °C
NTC-temperatur (opt.) NTC °C
Temperatur °F TEMP_F °F
NTC temperatur °F (opt.) NTC_F °F
Fuktighet HUMI rH%
Omgivelseslys LUX lux
CO2 CO2 ppm
PM2.5 PM2p5 jLg/m3
PM10 PM10 jLg/m3
TVOC (opt.) TVOC ppb
HCHO (opt.) HCHO ppb
CO (opt.) CO ppm
O3 (opt.) O3 ppb

 

Tabell 2 Data for glidende gjennomsnitt for sensor

Sensortype Nøkkel Dataenhet Regelbeskrivelse
CO2 CO2_ma ppm 8 timer
PM2.5 PM2p5_ma jLg/m3 24 timer
PM10 PM10_ma jLg/m3 24 timer
TVOC (opt.) TVOC_ma ppb 1 timer
HCHO (opt.) HCHO_ma ppb 1 timer
CO (opt.) CO_ma ppm 8 timer
O3 (opt.) O3_ma ppb 8 timer

PS. Hvis verdien på sensoren er "null" vises umontert eller data utilgjengelig.

API-manual

Behov

Skjermbilde av Postman
Figur 1 Postman-skjermbilde

API

Nåværende UNOweb gir følgende HTTP API for UNOneste. https://isdweb.deltaww.com/api/getUnoNextPeriod

Tabell 3 får Uno Next Period Usage

API Protokoll Beskrivelse
getUnoNextPeriod STOLPE Få UNOnext-data basert på glidende gjennomsnittsdata.
Autorisasjon: Bearer Token (i HTTP-forespørselshode)
Brukertoken: Hver Format brukeren har et unikt token. Lengden er 32.

 

Bærer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Bærer F.eks
Innleggstekst (JSON-format)
{

"sn": "2040N00F0116",

"sensor": null,

"rtData": [],

"dataFormat": "dict",

"tsRange": null

}

JSON-nøkkelbeskrivelse

Nøkkel Beskrivelse
sn SN av tilhørte UNOnext.
sensor Gj.sn. i bevegelse data for sensorstrengarray. null betyr alle sensorer. Tom array [] betyr ingen interessert i flytting avg. data.
rtData Sanntidsdata for sensorstrengarray. null betyr ingen interesserte sanntidsdata. Tom array [] betyr alle sensordata.
dataformat Godta "dict","csv","json". Bruk "dict" i de fleste tilfeller.
tsRange Epoketid stamp array. [start, slutt] – [1613633000, 1613633201] null betyr siste data på 1 time. Epoke Eksampde: https://www.epochconverter.com/
Svar (applikasjon/json) 
{
"result": "SUC",
"nyttelast": {
"kolonner": [
"tid",
"TEMP",
"HUMI",
"LUX",
"NTC",
"TVOC",
"HCHO",
"CO",
"CO2",
"O3",
"PM2p5",
"PM10",
"TEMP_F",
«NTC_F»
],
"data": [
[
1619425800,
23.2,
67.57,
282,
null,
30000,
42,
0,
920,
0,
2,
1,
73.76,
null
]
]
},
"rawCount": 1,
"telle": 1
}

JSON-nøkkelbeskrivelse

Nøkkel Beskrivelse
resultat

"SUC" er VELLYKKET.

"FAIL" og "ERR" returneres med feilmelding.

nyttelast.kolonner

Reagert array presentert sensorkolonne. "tid" er epoke stamp. Andre finner du i tabell 1 og tabell 2

nyttelast.data Reagert nestet datamatrise, hvert element er matrisekorresponderende sensorkolonner. null betyr ingen data på dette tidspunktet stamp, umontert eller sensor unormal.
telle

Hvis "resultatet" er "SUC", viser "tellingen" lengden på gyldige data (ikke alle null data) array.

rawCount

Hvis "resultatet" er "SUC", viser "tellingen" lengden på data (inneholder alle null data) array.

 

 

Dokumenter / Ressurser

PDF thumbnailHTTP API-programvare
User Manual · HTTP API Software, HTTP API, Software

Referanser

Still et spørsmål

Use this section to ask about setup, compatibility, troubleshooting, or anything missing from this manual.

Still et spørsmål

Ask a question about setup, compatibility, troubleshooting, or anything missing from this manual.