Manual Pengguna Perisian DELTA HTTP API

Manual Pengguna Perisian DELTA HTTP API

kandungan bersembunyi

pengenalan

UNOnext ialah penderia pelbagai fungsi. Ia menyediakan Suhu (°C/°F), Kelembapan (rH%), Cahaya Ambien (lux), CO2 (ppm), PM2.5 (μg/m3), PM10 (μg/m3). Model lanjutan secara pilihan menyediakan TVOC (ppb), HCHO (ppb), CO (ppm), dan O3 (ppb). Dokumen ini memperkenalkan menggunakan UNOweb API HTTP untuk mendapatkan semula data penderia UNOnext berdasarkan format JSON. Selain itu, UNOweb API HTTP juga menyediakan data purata bergerak penderia berdasarkan peraturan Taiwan. Ketumpatan data ialah 1 rekod setiap 6 minit apabila UNOnext berada dalam talian.
Nota. UNOweb API HTTP hanya menyokong UNOnext yang telah ditetapkan WiFi dan disambungkan ke UNOweb.

Jadual 1 Jadual Sensor

Jenis Sensor	kunci	Unit Data
Suhu	TEMP	^°C
Suhu NTC (pilihan)	NTC	^°C
Suhu ^°F	TEMP_F	^°F
Suhu NTC ^°F (pilihan)	NTC_F	^°F
Kelembapan	HUMI	rH%
Cahaya Ambien	LUX	lux
CO2	CO2	ppm
PM2.5	PM2p5	jLg/m³
PM10	PM10	jLg/m³
TVOC (pilihan)	TVOC	ppb
HCHO (pilihan)	HCHO	ppb
CO (pilihan)	CO	ppm
O3 (pilihan)	O3	ppb

Jadual 2 Data Purata Pergerakan Sensor

Jenis Sensor	kunci	Unit Data	Penerangan Peraturan
CO2	CO2_ma	ppm	8 jam
PM2.5	PM2p5_ma	jLg/m³	24 jam
PM10	PM10_ma	jLg/m³	24 jam
TVOC (pilihan)	TVOC_ma	ppb	1 jam
HCHO (pilihan)	HCHO_ma	ppb	1 jam
CO (pilihan)	CO_ma	ppm	8 jam
O3 (pilihan)	O3_ma	ppb	8 jam

PS. Jika nilai penderia adalah "null" dibentangkan dinyahlekap atau data tidak tersedia.

Manual API

Keperluan

UNOweb akaun dengan kebenaran API token.
SN UNOnext dalam talian.
Sediakan klien API HTTP. Cth Posmen (https://www.postman.com/), reqBin (https://reqbin.com/)

Gambar rajah 1 Posmen tangkapan skrin

API

UNO semasaweb menyediakan API HTTP berikut untuk UNOnext. https://isdweb.deltaww.com/api/getUnoNextPeriod

Jadual 3 dapatkan Penggunaan Tempoh Seterusnya Uno

API	Protokol	Penerangan
getUnoNextPeriod	POS	Dapatkan data UNOnext berdasarkan data purata bergerak.
Keizinan: Token Pembawa (Dalam Pengepala Permintaan HTTP)
Token pengguna: Setiap satu Format	pengguna mempunyai token unik. Panjang ialah 32. Pembawa xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
pembawa Cth

Badan Siaran (Format JSON)
{ “sn”: “2040N00F0116”, "sensor": null, "rtData": [], “dataFormat”: “dikt”, "tsRange": null } Perihalan Kunci JSON
kunci	Penerangan
sn	SN milik UNOnext.
penderia	Purata bergerak data tatasusunan rentetan sensor. *null* bermakna semua sensor. Tatasusunan kosong [] bermakna tiada purata bergerak yang berminat. data.
rtData	Data masa nyata tatasusunan rentetan penderia. *null* bermakna tiada data masa nyata yang berminat. Tatasusunan kosong [] bermakna semua data sensor.
DataFormat	Terima “dict”,”csv”,”json”. Gunakan "dikt" untuk kebanyakan kes.
tsRange	Epoch time stamp tatasusunan. [mula, tamat] – [1613633000, 1613633201] *null* bermakna data terakhir dalam 1 jam. Epoch Example: https://www.epochconverter.com/

Respons (aplikasi/json)

{
"hasil": "SUC",
“muatan”: {
"lajur": [
"masa",
“SUHU”,
“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,
"kira": 1
}

Perihalan Kunci JSON

kunci	Penerangan
hasil	"SUC" ialah BERJAYA. "GAGAL" dan "ERR" dikembalikan dengan mesej ralat.
muatan.lajur	Lajur penderia dibentangkan tatasusunan menjawab. "masa" ialah zaman stamp. Lain-lain boleh didapati dalam Jadual 1 dan Jadual 2
muatan.data	Tatasusunan data bersarang yang dibalas, setiap item ialah lajur sensor yang sepadan dengan tatasusunan. null bermakna tiada data pada masa ini stamp, dinyahlekap atau penderia tidak normal.
kira	Jika "hasil" ialah "SUC", "kiraan" menunjukkan panjang data yang sah (bukan semua null data) tatasusunan.
rawCount	Jika "hasil" ialah "SUC", "kiraan" menunjukkan panjang data (mengandungi semua null data) tatasusunan.