DELTA HTTP API softversko uputstvo za upotrebu

DELTA HTTP API softversko uputstvo za upotrebu

Sadržaj sakriti

3 Dokumenti / Resursi

3.1 Reference

4 Related Posts

Uvod

UNOnext je višenamjenski senzor. Pruža temperaturu (°C/°F), vlažnost (rH%), ambijentalno svjetlo (luks), CO2 (ppm), PM2.5 (μg/m3), PM10 (μg/m3). Napredni model opciono pruža TVOC (ppb), HCHO (ppb), CO (ppm) i O3 (ppb). Ovaj dokument uvodi korištenje UNO-aweb HTTP API za preuzimanje podataka senzora UNOnext-a na osnovu JSON formata. Osim toga, UNOweb HTTP API takođe pruža podatke o pokretnom proseku senzora na osnovu tajvanske regulative. Gustina podataka je 1 zapis na 6 minuta kada je UNOnext na mreži.
Napomena. UNOweb HTTP API podržava samo UNOnext koji je već postavljen WiFi i povezan na UNOweb.

Tabela 1 Tabela senzora

Tip senzora	Ključ	Data Unit
Temperatura	TEMP	^°C
NTC temperatura (opcija)	NTC	^°C
Temperatura ^°F	TEMP_F	^°F
NTC temperatura ^°F (opcija)	NTC_F	^°F
Vlažnost	HUMI	rH%
Ambijentalno svjetlo	LUX	lux
CO2	CO2	ppm
PM2.5	PM2p5	jLg/m³
PM10	PM10	jLg/m³
TVOC (opcija)	TVOC	ppb
HCHO (opcija)	HCHO	ppb
CO (opcija)	CO	ppm
O3 (opcija)	O3	ppb

Tabela 2 Podaci o pokretnom prosjeku senzora

Tip senzora	Ključ	Data Unit	Opis pravila
CO2	CO2_ma	ppm	8 sati
PM2.5	PM2p5_ma	jLg/m³	24 sati
PM10	PM10_ma	jLg/m³	24 sati
TVOC (opcija)	TVOC_ma	ppb	1 sati
HCHO (opcija)	HCHO_ma	ppb	1 sati
CO (opcija)	CO_ma	ppm	8 sati
O3 (opcija)	O3_ma	ppb	8 sati

PS. Ako je vrijednost senzora “null” prikazana je nemontirana ili podaci nedostupni.

API priručnik

Requirement

UNOweb račun sa token API dozvolom.
On-line UNOnext-ov SN.
Pripremite HTTP API klijent. Npr Poštar (https://www.postman.com/), reqBin (https://reqbin.com/)

Slika 1 Snimak ekrana Poštara

API

Trenutni UNOweb pruža sljedeći HTTP API za UNOnext. https://isdweb.deltaww.com/api/getUnoNextPeriod

Tabela 3 dobije Uno korištenje sljedećeg perioda

API	Protokol	Opis
getUnoNextPeriod	POST	Dobijte UNOnext podatke na osnovu podataka o pokretnom prosjeku.
Autorizacija: token nosioca (u zaglavlju HTTP zahtjeva)
Korisnički token: Svaki Format	korisnik ima jedinstveni token. Dužina je 32. Nosilac xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Nosilac Npr

Tijelo posta (JSON format)
{ “sn”: “2040N00F0116”, “senzor”: null, “rtData”: [], “format podataka”: “dict”, “tsRange”: null } Opis ključa JSON
Ključ	Opis
sn	SN od UNOnext.
senzor	Moving avg. podaci niza senzorskih nizova. *null* znači svi senzori. Prazan niz [] znači prosj. podaci.
rtData	Podaci u realnom vremenu niza senzorskih nizova. *null* znači da nema zainteresovanih podataka u realnom vremenu. Prazan niz [] znači sve podatke senzora.
dataFormat	Prihvatite “dict”,”csv”,”json”. Koristite “dict” za većinu slučajeva.
tsRange	Vrijeme epohe svamp niz. [početak, kraj] – [1613633000, 1613633201] *null* znači posljednji podatak u 1 satu. Epoch Example: https://www.epochconverter.com/

Odgovor (aplikacija/json)

{
“rezultat”: “SUC”,
"korisni teret": {
“kolone”: [
"vrijeme",
“TEMP”,
“HUMI”,
“LUX”,
“NTC”,
“TVOC”,
“HCHO”,
“CO”,
“CO2”,
“O3”,
“PM2p5”,
“PM10”,
“TEMP_F”,
“NTC_F”
],
“podaci”: [
[
1619425800,
23.2,
67.57,
282,
null,
30000,
42,
0,
920,
0,
2,
1,
73.76,
null
] ] },
“rawCount”: 1,
"broj": 1
}

Opis ključa JSON

Ključ	Opis
rezultat	“SUC” je USPJEŠNO. “FAIL” i “ERR” se vraćaju s porukom o grešci.
payload.columns	Niz sa odgovorima predstavlja kolonu senzora. “vrijeme” je epoha svamp. Ostale se mogu naći u Tabeli 1 i Tabeli 2
payload.data	Odgovorio ugniježđeni niz podataka, svaka stavka je niz odgovarajućih senzorskih stupaca. null znači nema podataka u ovom trenutku stamp, nemontiran ili senzor neispravan.
count	Ako je “rezultat” “SUC”, “broj” predstavlja dužinu važećih podataka (ne svih null data) niz.
rawCount	Ako je “rezultat” “SUC”, “broj” predstavlja dužinu podataka (sadrži sve null data) niz.