DELTA HTTP API tarkvara kasutusjuhend

DELTA HTTP API tarkvara kasutusjuhend

Sisu peita

3 Dokumendid / Ressursid

3.1 Viited

4 Seotud postitused

Sissejuhatus

UNOext on multifunktsionaalne andur. See tagab temperatuuri (°C/°F), õhuniiskuse (rH%), ümbritseva valguse (lux), CO2 (ppm), PM2.5 (μg/m3), PM10 (μg/m3). Eelmudel pakub valikuliselt TVOC-d. (ppb), HCHO (ppb), CO (ppm) ja O3 (ppb). See dokument tutvustab UNO kasutamistweb HTTP API UNOexti andurite andmete toomiseks JSON-vormingus. Lisaks UNOweb HTTP API pakub ka Taiwani regulatsioonil põhinevaid anduri liikuvaid keskmisi andmeid. Andmete tihedus on 1 kirje 6 minuti kohta, kui UNOext on võrgus.
Märkus. UNOweb HTTP API toetab ainult UNOexti, mis on juba seadistatud WiFi ja ühendatud UNO-gaweb.

Tabel 1 Andurite tabel

Anduri tüüp	Võti	Andmeüksus
Temperatuur	TEMP	^°C
NTC temperatuur (valikuline)	NTC	^°C
Temperatuur ^°F	TEMP_F	^°F
NTC temperatuur ^°F (valikuline)	NTC_F	^°F
Niiskus	HUMI	rH%
Ümbritsev valgus	LUX	luks
CO2	CO2	ppm
PM2.5	PM2p5	jLg/m³
PM10	PM10	jLg/m³
TVOC (valikuline)	TVOC	ppb
HCHO (valikuline)	HCHO	ppb
CO (valikuline)	CO	ppm
O3 (valikuline)	O3	ppb

Tabel 2 Anduri liikuvad keskmised andmed

Anduri tüüp	Võti	Andmeüksus	Reegli kirjeldus
CO2	CO2_ma	ppm	8 tundi
PM2.5	PM2p5_ma	jLg/m³	24 tundi
PM10	PM10_ma	jLg/m³	24 tundi
TVOC (valikuline)	TVOC_ma	ppb	1 tundi
HCHO (valikuline)	HCHO_ma	ppb	1 tundi
CO (valikuline)	CO_ma	ppm	8 tundi
O3 (valikuline)	O3_ma	ppb	8 tundi

PS. Kui anduri väärtus on null, esitatakse ühendamata või andmed pole saadaval.

API käsiraamat

Nõue

UNOweb konto token API loaga.
On-line UNOexti SN.
Valmistage ette HTTP API klient. Nt Postimees (https://www.postman.com/), reqBin (https://reqbin.com/)

Joonis 1 Postimehe ekraanipilt

API

Praegune UNOweb pakub jaoks järgmist HTTP API-d UNOnext. https://isdweb.deltaww.com/api/getUnoNextPeriod

Tabel 3 hanki Uno järgmise perioodi kasutus

API	Protokoll	Kirjeldus
getUnoNextPeriod	POSTITA	Hankige libiseva keskmise andmetel põhinevad UNOexti andmed.
Volitus: kandja tunnus (HTTP päringu päises)
Kasutaja tunnus: iga Vorming	kasutajal on kordumatu tunnus. Pikkus on 32. Kandja xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Kandja Nt

Postituse sisu (JSON-vorming)
{ "sn": "2040N00F0116", "sensor": null, "rtData": [], "dataFormat": "dict", "tsRange": null } JSON-võtme kirjeldus
Võti	Kirjeldus
sn	UNOextile kuulunud SN.
andur	Liikuv keskm. anduri stringi massiivi andmed. *null* tähendab kogu andurit. Tühi massiiv [] tähendab, et pole huvitatud liikuvat keskm. andmeid.
rtData	Anduri stringi massiivi reaalajas andmed. *null* tähendab huvitatud reaalajas andmete puudumist. Tühi massiiv [] tähendab kõiki anduri andmeid.
dataFormat	Aktsepteerige "dict", "csv", "json". Enamikul juhtudel kasutage sõna "dict".
tsRange	Ajastu aeg stamp massiivi. [algus, lõpp] – [1613633000, 1613633201] *null* tähendab viimaseid andmeid 1 tunni jooksul. Epoch Example: https://www.epochconverter.com/

Vastus (rakendus/json)

{
"tulemus": "SUC",
"kasulik koormus": {
"veerud": [
"aeg",
"TEMP",
"HUMI",
"LUX",
"NTC",
"TVOC",
"HCHO",
"CO",
"CO2",
"O3",
"PM2p5",
"PM10",
"TEMP_F",
"NTC_F"
],
"andmed": [
[
1619425800,
23.2,
67.57,
282,
null,
30000,
42,
0,
920,
0,
2,
1,
73.76,
null
] ] },
"toores arv": 1,
"loendada": 1
}

JSON-võtme kirjeldus

Võti	Kirjeldus
tulemus	"SUC" on EDUKAS. "FAIL" ja "ERR" tagastatakse veateatega.
kasulik koormus.veerud	Vastatud massiiv esitas anduri veergu. "aeg" on epohhi stamp. Teised leiate tabelist 1 ja tabelist 2
kasulik koormus.andmed	Vastas pesastatud andmemassiivi, iga üksus on massiivile vastavad anduri veerud. null tähendab, et hetkel pole andmeid stamp, monteerimata või andur on ebanormaalne.
loendama	Kui "tulemus" on "SUC", näitab "loendus" kehtivate andmete pikkust (mitte kõiki null andmed) massiiv.
rawCount	Kui "tulemus" on "SUC", näitab "count" andmete pikkust (sisaldab kõiki null andmed) massiiv.