Llawlyfr Defnyddiwr Meddalwedd DELTA HTTP API

Llawlyfr Defnyddiwr Meddalwedd DELTA HTTP API

Cynnwys cuddio

3 Dogfennau / Adnoddau

3.1 Cyfeiriadau

4 Swyddi Cysylltiedig

Rhagymadrodd

Synwyryddion aml-swyddogaeth yw UNOnext. Mae'n darparu Tymheredd (°C/°F), Lleithder (rH%), Golau Amgylchynol (lux), CO2 (ppm), PM2.5 (μg/m3), PM10 (μg/m3). Mae'r model ymlaen llaw yn darparu TVOC yn ddewisol. (ppb), HCHO (ppb), CO (ppm), ac O3 (ppb). Mae'r ddogfen hon yn cyflwyno defnyddio UNOweb HTTP API i adfer data synhwyrydd yr UNOnext yn seiliedig ar fformat JSON. Yn ogystal, UNOweb Mae HTTP API hefyd yn darparu'r data cyfartalog symudol o synhwyrydd yn seiliedig ar reoliad Taiwan. Dwysedd y data yw 1 cofnod bob 6 munud pan fydd UNOnext ar-lein.
Nodyn. UNOweb Mae HTTP API ond yn cefnogi'r UNOnext sydd eisoes wedi'i osod yn WiFi ac wedi'i gysylltu ag UNOweb.

Tabl Synhwyrydd Tabl 1

Math Synhwyrydd	Allwedd	Uned Ddata
Tymheredd	TEMP	^°C
Tymheredd NTC (op.)	NTC	^°C
Tymheredd ^°F	TEMP_F	^°F
Tymheredd NTC ^°F (op.)	NTC_F	^°F
Lleithder	HUMI	rH%
Golau Amgylchynol	LUX	lux
CO2	CO2	ppm
PM2.5	PM2p5	jLg/m³
PM10	PM10	jLg/m³
TVOC (op.)	TVOC	ppb
HCHO (op.)	HCHO	ppb
CO (op.)	CO	ppm
O3 (op.)	O3	ppb

Tabl 2 Synhwyrydd Symud Data Cyfartalog

Math Synhwyrydd	Allwedd	Uned Ddata	Disgrifiad o'r Rheol
CO2	CO2_ma	ppm	8 awr
PM2.5	PM2p5_ma	jLg/m³	24 awr
PM10	PM10_ma	jLg/m³	24 awr
TVOC (op.)	TVOC_ma	ppb	1 awr
HCHO (op.)	HCHO_ma	ppb	1 awr
CO (op.)	CO_ma	ppm	8 awr
O3 (op.)	O3_ma	ppb	8 awr

PS. Os yw gwerth y synhwyrydd yn “nwl” wedi'i gyflwyno heb ei fowntio neu ddata ddim ar gael.

Llawlyfr API

Gofyniad

UNOweb cyfrif gyda chaniatâd tocyn API.
SN UNOnext ar-lein.
Paratoi cleient API HTTP. ae Postmon (https://www.postman.com/), reqBin (https://reqbin.com/)

Ffigur 1 Sgrinlun Postman

API

UNO cyfredolweb yn darparu API HTTP canlynol ar gyfer UNOnext. https://isdweb.deltaww.com/api/getUnoNextPeriod

Tabl 3 yn cael Uno Defnydd y Cyfnod Nesaf

API	Protocol	Disgrifiad
caelUnoNextPeriod	SWYDD	Cael data UNOnext yn seiliedig ar symud data cyfartalog.
Awdurdodiad: Tocyn Cludwyr (Mewn Pennawd Cais HTTP)
Tocyn defnyddiwr: Pob un Fformat	Mae gan y defnyddiwr docyn unigryw. Hyd yw 32. Cludwr xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Cludwr ae

Corff Postio (Fformat JSON)
{ “sn”: “2040N00F0116”, “synhwyrydd”: null, “rtData”: [], “Fformat data”: “dict”, “tsRange”: null } Disgrifiad Allwedd JSON
Allwedd	Disgrifiad
sn	SN o perthyn UNOnext.
synhwyrydd	Symud cyf. data arae llinynnau synhwyrydd. *null* yn golygu pob synhwyrydd. Arae gwag [] yn golygu dim diddordeb symud avg. data.
rtData	Data amser real o arae llinynnau synhwyrydd. *null* yn golygu dim data amser real o ddiddordeb. Arae gwag [] yn golygu holl ddata synhwyrydd.
Fformat data	Derbyn “dict”, “csv”, “json”. Defnyddiwch “dict” yn y rhan fwyaf o achosion.
tsRyd	amser epoc stamp arae. [dechrau, diwedd] – [1613633000, 1613633201] *null* yn golygu'r data olaf mewn 1 awr. Epoch Example: https://www.epochconverter.com/

Ymateb (cais/json)

{
“canlyniad”: “SUC”,
“llwyth cyflog”: {
“colofnau”: [
“amser”,
“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
]] },
“Cyfrif amrwd”: 1,
“cyfrif”: 1
}

Disgrifiad Allwedd JSON

Allwedd	Disgrifiad
canlyniad	“SUC” yw LLWYDDIANNUS. Mae “METHU” ac “ERR” yn dychwelyd gyda neges gwall.
payload.columns	Arae ymatebol a gyflwynwyd colofn synhwyrydd. “amser” yw epoc stamp. Mae eraill i’w gweld yn Nhabl 1 a Thabl 2
data.llwyth	Arae data nythu ymateb, mae pob eitem yn arae colofnau synhwyrydd cyfatebol. null yn golygu dim data ar hyn o bryd stamp, heb ei osod neu synhwyrydd yn annormal.
cyfrif	Os mai “SUC” yw’r “canlyniad”, mae’r “cyfrif” yn cyflwyno hyd y data dilys (nid pob un null data) arae.
craiCyf	Os mai’r “canlyniad” yw “SUC”, mae’r “cyfrif” yn cyflwyno hyd y data (cynnwys y cyfan null data) arae.