DELTA HTTP API -ohjelmiston käyttöopas
Johdanto
UNOext on monitoimisensorit. Se tarjoaa lämpötilan (°C/°F), kosteuden (rH%), ympäristön valon (lux), CO2 (ppm), PM2.5 (μg/m3), PM10 (μg/m3). Edistyksellinen malli tarjoaa valinnaisesti TVOC:n (ppb), HCHO (ppb), CO (ppm) ja O3 (ppb). Tämä asiakirja esittelee UNO:n käytönweb HTTP API noutaa UNOextin anturitiedot JSON-muotoon perustuen. Lisäksi UNOweb HTTP API tarjoaa myös anturin liukuvat keskiarvotiedot Taiwanin sääntelyn perusteella. Tietotiheys on 1 tietue 6 minuutissa, kun UNOext on online-tilassa.
Huom. UNOweb HTTP API tukee vain UNOextiä, joka on jo asetettu WiFi ja yhdistetty UNO:hanweb.
Taulukko 1 Anturitaulukko
| Anturin tyyppi | Avain | Tietoyksikkö |
| Lämpötila | TEMP | °C |
| NTC-lämpötila (valinnainen) | NTC | °C |
| Lämpötila °F | TEMP_F | °F |
| NTC lämpötila °F (valinnainen) | NTC_F | °F |
| Kosteus | HUMI | rH% |
| Ambient Light | LUX | lux |
| CO2 | CO2 | ppm |
| PM2.5 | PM2p5 | jLg/m3 |
| PM10 | PM10 | jLg/m3 |
| TVOC (valinnainen) | TVOC | ppb |
| HCHO (valinnainen) | HCHO | ppb |
| CO (valinnainen) | CO | ppm |
| O3 (valinnainen) | O3 | ppb |
Taulukko 2 Anturin liikkuvan keskiarvon tiedot
| Anturin tyyppi | Avain | Tietoyksikkö | Säännön kuvaus |
| CO2 | CO2_ma | ppm | 8 tuntia |
| PM2.5 | PM2p5_ma | jLg/m3 | 24 tuntia |
| PM10 | PM10_ma | jLg/m3 | 24 tuntia |
| TVOC (valinnainen) | TVOC_ma | ppb | 1 tuntia |
| HCHO (valinnainen) | HCHO_ma | ppb | 1 tuntia |
| CO (valinnainen) | Kooma | ppm | 8 tuntia |
| O3 (valinnainen) | O3_ma | ppb | 8 tuntia |
PS. Jos anturin arvo on "nolla", se esitetään asentamattomana tai tietoja ei ole saatavilla.
API käsikirja
Vaatimus
- UNOweb tili token API-luvalla.
- Online-UNOnextin SN.
- Valmistele HTTP API -asiakas. Esim Postinkantaja (https://www.postman.com/), reqBin (https://reqbin.com/)
Kuva 1 Postimiehen kuvakaappaus
API
Nykyinen UNOweb tarjoaa seuraavan HTTP API:n UNOnext. https://isdweb.deltaww.com/api/getUnoNextPeriod
Taulukko 3 saada Uno seuraavan kauden käyttö
| API | pöytäkirja | Kuvaus |
| getUnoNextPeriod | LÄHETTÄÄ | Hanki UNOext-tiedot liukuvan keskiarvon tietojen perusteella. |
| Valtuutus: Bearer Token (HTTP-pyynnön otsikossa) | ||
| Käyttäjätunnus: Jokainen Muoto | käyttäjällä on ainutlaatuinen tunnus. Pituus on 32.
Kantaja xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
|
| Kantaja Esim | ||
| Viestiteksti (JSON-muoto) | ||
| {
"sn": "2040N00F0116", "anturi": tyhjä, "rtData": [], "dataFormat": "dict", "tsRange": tyhjä } JSON-avaimen kuvaus |
||
| Avain | Kuvaus | |
| sn | SN:lle kuului UNOext. | |
| anturi | Liikkuva keskim. anturin merkkijonotaulukon tiedot. tyhjä tarkoittaa kaikkea anturia. Tyhjä joukko [] tarkoittaa ei kiinnostunut liikkuva keskim. tiedot. | |
| rtData | Anturijonojoukon reaaliaikainen data. tyhjä tarkoittaa, että ei kiinnosta reaaliaikaista dataa. Tyhjä joukko [] tarkoittaa kaikkia anturin tietoja. | |
| dataFormat | Hyväksy "dict", "csv", "json". Käytä sanaa "dict" useimmissa tapauksissa. | |
| tsRange | Epochin aika stamp joukko. [alku, loppu] – [1613633000, 1613633201] tyhjä tarkoittaa viimeistä dataa 1 tunnin sisällä. Epoch Exampseuraavat: https://www.epochconverter.com/ | |
| Vastaus (sovellus/json) | ||||||||||||
| { "tulos": "SUC", "hyötykuorma": { "sarakkeet": [ "aika", "TEMP", "HUMI", "LUX", "NTC", "TVOC", "HCHO", "CO", "CO2", "O3", "PM2p5", "PM10", "TEMP_F", "NTC_F" ], "Data": [ [ 1619425800 XNUMX XNUMX, 23.2 XNUMX XNUMX, 67.57 XNUMX XNUMX, 282 XNUMX XNUMX, nolla, 30000 XNUMX XNUMX, 42 XNUMX XNUMX, 0, 920 XNUMX XNUMX, 0, 2, 1, 73.76 XNUMX XNUMX, tyhjä ] ] }, "raakaluku": 1, "laske": 1 } JSON-avaimen kuvaus
|
Asiakirjat / Resurssit
 | HTTP API -ohjelmisto |
Viitteet
- Käyttöopasmanual.tools