Mwongozo wa Mtumiaji wa Programu ya API ya DELTA HTTP
Utangulizi
UNOnext ni vitambuzi vya kazi nyingi. Inatoa Halijoto (°C/°F), Unyevu (rH%), Mwangaza Turi (lux), CO2 (ppm), PM2.5 (μg/m3), PM10 (μg/m3). Muundo wa mapema hutoa TVOC kwa hiari. (ppb), HCHO (ppb), CO (ppm), na O3 (ppb). Hati hii inatanguliza kwa kutumia UNOweb HTTP API ili kuepua data ya kihisi cha UNONext kulingana na umbizo la JSON. Kwa kuongeza, UNOweb HTTP API pia hutoa data wastani inayosonga ya kitambuzi kulingana na kanuni za Taiwan. Msongamano wa data ni rekodi 1 kwa dakika 6 wakati UNONext iko mtandaoni.
Kumbuka. UNOweb HTTP API inasaidia tu UNONext ambayo tayari imewekwa WiFi na imeunganishwa kwa UNOweb.
Jedwali 1 la Sensor
| Aina ya Sensor | Ufunguo | Kitengo cha Data |
| Halijoto | TEMP | °C |
| Halijoto ya NTC (chaguo.) | NTC | °C |
| Halijoto °F | TEMP_F | °F |
| Joto la NTC °F (chaguo.) | NTC_F | °F |
| Unyevu | HUMI | rH% |
| Mwanga wa Mazingira | LUX | lux |
| CO2 | CO2 | ppm |
| PM2.5 | PM2p5 | jLg/m3 |
| PM10 | PM10 | jLg/m3 |
| TVOC (chaguo.) | TVOC | ppb |
| HCHO (chaguo.) | HCHO | ppb |
| CO (chaguo.) | CO | ppm |
| O3 (chaguo.) | O3 | ppb |
Jedwali la 2 la Sensor ya Wastani ya Kusogeza Data
| Aina ya Sensor | Ufunguo | Kitengo cha Data | Maelezo ya Kanuni |
| CO2 | CO2_ma | ppm | 8 masaa |
| PM2.5 | PM2p5_ma | jLg/m3 | 24 masaa |
| PM10 | PM10_ma | jLg/m3 | 24 masaa |
| TVOC (chaguo.) | TVOC_ma | ppb | 1 masaa |
| HCHO (chaguo.) | HCHO_ma | ppb | 1 masaa |
| CO (chaguo.) | CO_ma | ppm | 8 masaa |
| O3 (chaguo.) | O3_ma | ppb | 8 masaa |
PS. Ikiwa thamani ya kihisi ni "batili" iliyotolewa bila kupachikwa au data haipatikani.
Mwongozo wa API
Sharti
- UNOweb akaunti yenye idhini ya API ya ishara.
- SN ya mtandaoni ya UNOnext.
- Tayarisha kiteja cha HTTP API. Mfano Mtumishi wa posta (https://www.postman.com/), reqBin (https://reqbin.com/)
Kielelezo cha 1 picha ya skrini ya Posta
API
UNO ya sasaweb hutoa API ifuatayo ya HTTP kwa UNOIfuatayo. https://isdweb.deltaww.com/api/getUnoNextPeriod
Jedwali la 3 pata Matumizi ya Kipindi Kijacho cha Uno
| API | Itifaki | Maelezo |
| getUnoNextPeriod | POST | Pata UNONext data kulingana na kuhamisha data wastani. |
| Uidhinishaji: Tokeni ya Bearer (Katika Kichwa cha Ombi la HTTP) | ||
| Ishara ya mtumiaji: Kila Umbizo | mtumiaji ana ishara ya kipekee. Urefu ni 32.
Mshikaji xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
|
| Mbebaji Mfano | ||
| Mwili wa Chapisho (Muundo wa JSON) | ||
| {
"sn": "2040N00F0116", "sensor": null, "rtData": [], "dataFormat": "dict", "tsRange": null } Maelezo Muhimu ya JSON |
||
| Ufunguo | Maelezo | |
| sn | SN ya ilimilikiwa na UNOInayofuata. | |
| sensor | Wastani wa kuhamisha. data ya safu ya kamba ya sensorer. null inamaanisha sensor zote. Safu tupu [] inamaanisha hakuna nia ya kusonga wastani. data. | |
| rtData | Data ya wakati halisi ya safu ya mfuatano wa kihisi. null inamaanisha hakuna data ya wakati halisi inayovutiwa. Safu tupu [] inamaanisha data zote za kihisi. | |
| DataFormat | Kubali “dict”,”csv”,”json”. Tumia "dict" kwa kesi nyingi. | |
| tsRange | Wakati wa Epoch stamp safu. [anza, mwisho] - [1613633000, 1613633201] null inamaanisha data ya mwisho katika saa 1. Enzi Example: https://www.epochconverter.com/ | |
| Jibu (maombi/json) | ||||||||||||
| { "matokeo": "SUC", "mzigo wa malipo": { "safu": [ "wakati", "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 ]]}, "Hesabu ghafi": 1, "hesabu": 1 } Maelezo Muhimu ya JSON
|
Nyaraka / Rasilimali
 |
Programu ya API ya DELTA HTTP [pdf] Mwongozo wa Mtumiaji Programu ya API ya HTTP, API ya HTTP, Programu |
