Manual d'usuari del programari DELTA HTTP API

Manual d'usuari del programari DELTA HTTP API

Continguts amagar

4 Publicacions relacionades

Introducció

UNOnext és un sensor multifunció. Proporciona temperatura (°C/°F), humitat (rH%), llum ambiental (lux), CO2 (ppm), PM2.5 (μg/m3), PM10 (μg/m3). El model avançat ofereix opcionalment TVOC (ppb), HCHO (ppb), CO (ppm) i O3 (ppb). Aquest document presenta l'ús d'UNOweb API HTTP per recuperar les dades del sensor d'UNOnext basades en format JSON. A més, l'ONUweb L'API HTTP també proporciona les dades mitjanes mòbils del sensor basades en la regulació de Taiwan. La densitat de dades és d'1 registre cada 6 minuts quan UNOnext està en línia.
Nota. UNOweb L'API HTTP només admet UNOnext que ja està configurat per WiFi i connectat a UNOweb.

Taula 1 Taula de sensors

Tipus de sensor	clau	Unitat de dades
Temperatura	TEMP	^°C
Temperatura NTC (opcional)	NTC	^°C
Temperatura ^°F	TEMP_F	^°F
Temperatura NTC ^°F (opta.)	NTC_F	^°F
Humitat	HUMI	rH%
Llum ambiental	LUX	lux
CO2	CO2	ppm
PM2.5	PM2p5	jLg/m³
PM10	PM10	jLg/m³
TVOC (opta.)	TVOC	ppb
HCHO (opta.)	HCHO	ppb
CO (opta.)	CO	ppm
O3 (opta.)	O3	ppb

Taula 2 Dades de mitjana mòbil del sensor

Tipus de sensor	clau	Unitat de dades	Descripció de la regla
CO2	CO2_ma	ppm	8 hores
PM2.5	PM2p5_ma	jLg/m³	24 hores
PM10	PM10_ma	jLg/m³	24 hores
TVOC (opta.)	TVOC_ma	ppb	1 hores
HCHO (opta.)	HCHO_ma	ppb	1 hores
CO (opta.)	CO_ma	ppm	8 hores
O3 (opta.)	O3_ma	ppb	8 hores

PS. Si el valor del sensor és "nul" es presenta desmuntat o les dades no estan disponibles.

Manual de l'API

Requisit

UNOweb compte amb permís de l'API de testimoni.
Un SN d'UNOnext en línia.
Prepareu un client d'API HTTP. Ex Carter (https://www.postman.com/), reqBin (https://reqbin.com/)

Figura 1 Captura de pantalla del carter

API

Actualitat de l'ONUweb proporciona la següent API HTTP per UNOnext. https://isdweb.deltaww.com/api/getUnoNextPeriod

La Taula 3 obteniu l'ús del proper període Uno

API	Protocol	Descripció
getUnoNextPeriod	PUBLICACIÓ	Obteniu dades d'UNOnext basades en dades de mitjana mòbil.
Autorització: testimoni del portador (a la capçalera de la sol·licitud HTTP)
Fitxa d'usuari: cadascuna Format	l'usuari té un testimoni únic. La longitud és de 32. Portador xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Portador Ex

Cos de la publicació (format JSON)
{ “sn”: “2040N00F0116”, "sensor": nul, “rtData”: [], “dataFormat”: “dict”, “tsRange”: nul } Descripció de la clau JSON
clau	Descripció
sn	SN de UNOnext pertanyent.
sensor	Mitjana en moviment dades de la matriu de cadenes del sensor. *nul·la* significa tots els sensors. Matriu buida [] significa que no hi ha cap interès en moure la mitjana. dades.
rtData	Dades en temps real de la matriu de cadenes del sensor. *nul·la* significa que no hi ha dades interessades en temps real. Matriu buida [] significa totes les dades del sensor.
dataFormat	Accepteu "dict", "csv", "json". Utilitzeu "dict" en la majoria dels casos.
tsRange	Època stamp matriu. [inici, final] – [1613633000, 1613633201] *nul·la* significa les darreres dades en 1 hora. Època ExampLI: https://www.epochconverter.com/

Resposta (aplicació/json)

{
“resultat”: “SUC”,
"càrrega útil": {
"columnes": [
"temps",
"TEMP",
"HUMI",
"LUX",
"NTC",
"TVOC",
"HCHO",
"CO",
"CO2",
"O3",
"PM2p5",
"PM10",
"TEMP_F",
"NTC_F"
],
"dades": [
[
1619425800,
23.2,
67.57,
282,
nul,
30000,
42,
0,
920,
0,
2,
1,
73.76,
nul·la
] ] },
"rawCount": 1,
"compte": 1
}

Descripció de la clau JSON

clau	Descripció
resultat	"SUC" és ÈXIT. "FAIL" i "ERR" es tornen amb un missatge d'error.
càrrega útil.columnes	Columna del sensor presentada per la matriu de resposta. "temps" és l'època stamp. Altres es poden trobar a la taula 1 i a la taula 2
càrrega útil.dades	Matriu de dades imbricades amb resposta, cada element és la matriu corresponent a les columnes del sensor. nul·la vol dir que no hi ha dades en aquest moment stamp, sense muntar o sensor anormal.
comptar	Si el "resultat" és "SUC", el "compte" presenta la longitud de les dades vàlides (no totes nul·la matriu de dades).
rawCount	Si el "resultat" és "SUC", el "compte" presenta la longitud de les dades (conté tot nul·la matriu de dades).