Manual de utilizare al software-ului DELTA HTTP API

Manual de utilizare al software-ului DELTA HTTP API

Cuprins ascunde

Introducere

UNOnext este un senzor multifuncțional. Oferă temperatură (°C/°F), umiditate (rH%), lumină ambientală (lux), CO2 (ppm), PM2.5 (μg/m3), PM10 (μg/m3). Modelul avansat oferă opțional TVOC (ppb), HCHO (ppb), CO (ppm) și O3 (ppb). Acest document prezintă utilizarea UNOweb HTTP API pentru a prelua datele senzorului UNOnext pe baza formatului JSON. În plus, ONUweb HTTP API oferă, de asemenea, datele medii mobile ale senzorului pe baza reglementărilor din Taiwan. Densitatea datelor este de 1 înregistrare la 6 minute când UNOnext este online.
Nota. O.N.U.web HTTP API acceptă numai UNOnext, care este deja setat WiFi și conectat la UNOweb.

Tabelul 1 Tabelul cu senzori

Tip senzor	Cheie	Unitatea de date
Temperatură	TEMP	^°C
Temperatura NTC (opt.)	NTC	^°C
Temperatură ^°F	TEMP_F	^°F
Temperatura NTC ^°F (opțional)	NTC_F	^°F
Umiditate	HUMI	rH%
Lumină ambientală	LUX	lux
CO2	CO2	ppm
PM2.5	PM2p5	jLg/m³
PM10	PM10	jLg/m³
TVOC (opt.)	TVOC	ppb
HCHO (opt.)	HCHO	ppb
CO (opt.)	CO	ppm
O3 (opt.)	O3	ppb

Tabelul 2 Date medii mobile ale senzorului

Tip senzor	Cheie	Unitatea de date	Descrierea regulii
CO2	CO2_ma	ppm	8 de ore
PM2.5	PM2p5_ma	jLg/m³	24 de ore
PM10	PM10_ma	jLg/m³	24 de ore
TVOC (opt.)	TVOC_ma	ppb	1 de ore
HCHO (opt.)	HCHO_ma	ppb	1 de ore
CO (opt.)	Comă	ppm	8 de ore
O3 (opt.)	O3_ma	ppb	8 de ore

PS. Dacă valoarea senzorului este „nulă” este prezentată nemontată sau datele indisponibile.

Manual API

Cerinţă

O.N.U.web cont cu permisiunea token API.
Un SN on-line al ONUnext.
Pregătiți un client API HTTP. De exemplu Poştaş (https://www.postman.com/), reqBin (https://reqbin.com/)

Figura 1 Captură de ecran Poștaș

API

Actuala ONUweb furnizează următorul API HTTP pentru UNOnext. https://isdweb.deltaww.com/api/getUnoNextPeriod

Tabelul 3 obține Uno Următoarea perioadă de utilizare

API	Protocol	Descriere
obțineUnoUrmătoareaPeriodă	POST	Obțineți date UNONext pe baza datelor medii mobile.
Autorizare: Bearer Token (În antetul cererii HTTP)
Jeton de utilizator: Fiecare Format	utilizatorul are un simbol unic. Lungimea este de 32. Purtător xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Purtător De ex

Corpul postării (format JSON)
{ „sn”: „2040N00F0116”, „senzor”: nul, „rtData”: [], „dataFormat”: „dict”, „tsRange”: nul } Descrierea cheii JSON
Cheie	Descriere
sn	SN a aparținut UNOnext.
senzor	În mișcare medie datele matricei de șiruri de senzori. *nul* înseamnă tot senzorul. Matrice goală [] înseamnă că nu este interesat de mișcare medie. date.
rtData	Date în timp real ale matricei de șiruri de senzori. *nul* înseamnă că nu există date interesate în timp real. Matrice goală [] înseamnă toate datele senzorului.
Format de date	Acceptați „dict”, „csv”, „json”. Folosiți „dict” în majoritatea cazurilor.
tsRange	Epocă stamp matrice. [început, sfârșit] – [1613633000, 1613633201] *nul* înseamnă ultimele date în 1 oră. Epoca Examppe: https://www.epochconverter.com/

Răspuns (aplicație/json)

{
„rezultat”: „SUC”,
„sarcină utilă”: {
„coloane”: [
"timp",
„TEMP”,
„HUMI”,
"LUX",
„NTC”,
„TVOC”,
„HCHO”,
„CO”,
„CO2”,
„O3”,
„PM2p5”,
„PM10”,
„TEMP_F”,
„NTC_F”
],
"date": [
[
1619425800,
23.2,
67.57,
282,
nul,
30000,
42,
0,
920,
0,
2,
1,
73.76,
nul
] ] },
„rawCount”: 1,
„număr”: 1
}

Descrierea cheii JSON

Cheie	Descriere
rezultat	„SUC” este DE SUCCES. „FAIL” și „ERR” sunt returnate cu un mesaj de eroare.
sarcină utilă.coloane	Matricea cu răspuns a prezentat coloana senzorului. „timpul” este epoca stamp. Altele pot fi găsite în Tabelul 1 și Tabelul 2
încărcătură.date	Răspuns matrice de date imbricate, fiecare articol este matrice corespunzatoare coloane senzor. nul înseamnă că nu există date în acest moment stamp, nemontat sau senzor anormal.
conta	Dacă „rezultatul” este „SUC”, „numărarea” prezintă lungimea datelor valide (nu toate nul date) matrice.
număr brut	Dacă „rezultatul” este „SUC”, „numărarea” prezintă lungimea datelor (conține toate nul date) matrice.