Lámhleabhar úsáideora Bogearraí DELTA HTTP API
Réamhrá
Is braiteoirí ilfheidhme é UNOnext. Soláthraíonn sé Teocht (°C/°F), Taise (rH%), Solas Comhthimpeallach (lux), CO2 (ppm), PM2.5 (μg/m3), PM10 (μg/m3). Soláthraíonn an tsamhail roimh ré go roghnach TVOC (ppb), HCHO (ppb), CO (ppm), agus O3 (ppb). Tugann an doiciméad seo isteach ag baint úsáide as UNOweb HTTP API chun sonraí braiteora an UNOnext a aisghabháil bunaithe ar fhormáid JSON. Ina theannta sin, UNOweb Soláthraíonn HTTP API freisin na sonraí meán gluaiseachta braiteoir bunaithe ar rialachán Taiwan. Is é dlús na sonraí ná taifead amháin in aghaidh 1 nóiméad nuair a bhíonn an UNOnext ar líne.
Nóta. UNOweb Ní thacaíonn HTTP API ach leis an UNOnext atá socraithe cheana féin WiFi agus ceangailte le UNOweb.
Tábla 1 Braiteoir
| Cineál Braiteoir | eochair | Aonad Sonraí |
| Teocht | TEMP | °C |
| Teocht NTC (rogha.) | NTC | °C |
| Teocht °F | TEMP_F | °F |
| Teocht NTC °F (rogha.) | NTC_F | °F |
| Taiseachas | HUMI | rH% |
| Solas Comhthimpeallach | LUX | lux |
| CO2 | CO2 | ppm |
| PM2.5 | PM2p5 | jLg/m3 |
| PM10 | PM10 | jLg/m3 |
| TVOC (rogha.) | TVOC | ppb |
| HCHO (rogha.) | HCHO | ppb |
| CO (rogha.) | CO | ppm |
| O3 (rogha.) | O3 | ppb |
Tábla 2 Braiteoir ag Bogadh Meánshonraí
| Cineál Braiteoir | eochair | Aonad Sonraí | Cur síos ar Riail |
| CO2 | CO2_ma | ppm | 8 uair |
| PM2.5 | PM2p5_ma | jLg/m3 | 24 uair |
| PM10 | PM10_ma | jLg/m3 | 24 uair |
| TVOC (rogha.) | TVOC_ma | ppb | 1 uair |
| HCHO (rogha.) | HCHO_ma | ppb | 1 uair |
| CO (rogha.) | CO_ma | ppm | 8 uair |
| O3 (rogha.) | Ó3_ma | ppb | 8 uair |
PS. Más rud é gur “nall” luach an bhraiteora léirithe gan gléasadh nó nach bhfuil sonraí ar fáil.
Lámhleabhar API
Riachtanas
- UNOweb cuntas le cead comhartha API.
- SN UNOnext ar líne.
- Ullmhaigh cliant API HTTP. E.g Fear an Phoist (https://www.postman.com/), reqBin (https://reqbin.com/)
Figiúr 1 Fear an Phoist gabháil scáileáin
API
UNO reathaweb Soláthraíonn HTTP API seo a leanas le haghaidh AONAD. https://isdweb.deltaww.com/api/getUnoNextPeriod
Faigheann Tábla 3 Úsáid Uno don Chéad Tréimhse Eile
| API | Prótacal | Cur síos |
| getUnoNextPeriod | POST | Faigh sonraí UNOnext bunaithe ar shonraí meán gluaiseachta. |
| Údarú: Iompróir Chomhartha (I gCeanntásc Iarratas HTTP) | ||
| Comhartha úsáideora: Gach ceann Formáid | Tá comhartha uathúil ag an úsáideoir. Is é 32 an fad.
Iompróir xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
|
| Iompróir E.g | ||
| Corp Postála (Formáid JSON) | ||
| {
“sn”: “2040N00F0116”, “braiteoir”: null, “rtData”: [], “Formáid sonraí”: “dict”, “TSRange”: null } Cur síos ar an Eochair JSON |
||
| eochair | Cur síos | |
| sn | SN de chuid UNOnext. | |
| braiteoir | Bogadh meánlíon. sonraí de shraith teaghrán braiteora. null ciallaíonn gach braiteoir. Eagar folamh [] ciallaíonn aon suim ag gluaiseacht meánlíon. sonraí. | |
| rtSonraí | Sonraí fíor-ama d'eagar teaghrán braiteora. null ciallaíonn sé nach bhfuil aon suim sonraí fíor-ama. Eagar folamh [] ciallaíonn sé na sonraí braiteora go léir. | |
| Formáid sonraí | Glac le “dict”, “csv”, “json”. Úsáid “dict” don chuid is mó de chásanna. | |
| tsRaon | am Aga stamp eagar. [tús, deireadh] – [1613633000, 1613633201] null ciallaíonn sé na sonraí deiridh i 1 uair an chloig. Sean Agaample: https://www.epochconverter.com/ | |
| Freagra (iarratas/ json) | ||||||||||||
| { “toradh”: “SUC”, “pálasta”: { “colúin”: [ “am”, “TEMP”, “HUMI”, “LUX”, “NTC”, “TVOC”, “HCHO”, “CO”, “CO2”, "O3", “PM2p5”, “PM10”, “TEMP_F”, “NTC_F” ], “sonraí”: [ [ 1619425800, 23.2, 67.57, 282, null, 30000, 42, 0, 920, 0, 2, 1, 73.76, null ] ] }, “RawCount”: 1, “Comhaireamh”: 1 } Cur síos ar an Eochair JSON
|
Doiciméid / Acmhainní
 | Bogearraí HTTP API |
Tagairtí
- Uirlis Tástála API Ar Líne | Tástáil Do API Ar Línereqbin.com
- Tiontaire Aga - Unix Timestamp Tiontairewww.epochconverter.com
- Postman: The World's Leading API Platform | Sign Up for Freewww.postman.com
- Lámhleabhar Úsáideoramanual.tools