Εγχειρίδιο χρήστη DELTA HTTP API Software
λογότυπο λογισμικού ταχυδρόμος

Εισαγωγή

Το UNONext είναι ένας αισθητήρας πολλαπλών λειτουργιών. Παρέχει θερμοκρασία (°C/°F), υγρασία (rH%), φως περιβάλλοντος (lux), CO2 (ppm), PM2.5 (μg/m3), PM10 (μg/m3). Το προηγμένο μοντέλο παρέχει προαιρετικά TVOC (ppb), HCHO (ppb), CO (ppm) και O3 (ppb). Αυτό το έγγραφο εισάγει τη χρήση UNOweb HTTP API για ανάκτηση των δεδομένων αισθητήρα του UNOnext με βάση τη μορφή JSON. Επιπλέον, ΟΗΕweb Το HTTP API παρέχει επίσης τα δεδομένα κινητού μέσου όρου του αισθητήρα με βάση τον κανονισμό της Ταϊβάν. Η πυκνότητα δεδομένων είναι 1 εγγραφή ανά 6 λεπτά όταν το UNOnext είναι συνδεδεμένο.
Σημείωμα. ΟΗΕweb Το HTTP API υποστηρίζει μόνο το UNOnext που είναι ήδη ρυθμισμένο WiFi και είναι συνδεδεμένο στο UNOweb.

Πίνακας 1 Πίνακας αισθητήρων

Τύπος αισθητήρα Κλειδί Μονάδα Δεδομένων
Θερμοκρασία ΘΕΡΜΟΚΡΑΣΙΑ °C
Θερμοκρασία NTC (προαιρετικό) NTC °C
Θερμοκρασία °F TEMP_F °F
Θερμοκρασία NTC °F (επιλογή) NTC_F °F
Υγρασία HUMI rH%
Φως περιβάλλοντος LUX lux
CO2 CO2 ppm
PM2.5 PM2p5 jLg/m3
PM10 PM10 jLg/m3
TVOC (επιλογή) TVOC ppb
HCHO (επιλογή) ΧΧΟ ppb
CO (επιλογή) CO ppm
O3 (επιλογή) O3 ppb

 

Πίνακας 2 Μετακινούμενο μέσο όρο δεδομένων αισθητήρα

Τύπος αισθητήρα Κλειδί Μονάδα Δεδομένων Περιγραφή κανόνα
CO2 CO2_ma ppm 8 ώρες
PM2.5 PM2p5_ma jLg/m3 24 ώρες
PM10 PM10_ma jLg/m3 24 ώρες
TVOC (επιλογή) TVOC_ma ppb 1 ώρες
HCHO (επιλογή) HCHO_ma ppb 1 ώρες
CO (επιλογή) Κώμα ppm 8 ώρες
O3 (επιλογή) O3_ma ppb 8 ώρες

ΥΓ. Εάν η τιμή του αισθητήρα είναι "μηδενική", παρουσιάζεται μη προσαρτημένη ή τα δεδομένα δεν είναι διαθέσιμα.

Εγχειρίδιο API

Απαίτηση
  • ΟΗΕweb λογαριασμό με άδεια API διακριτικού.
  • Ένα σε απευθείας σύνδεση SN του UNOnext.
  • Προετοιμάστε ένα πρόγραμμα-πελάτη HTTP API. Π.χ Ταχυδρόμος (https://www.postman.com/), reqBin (https://reqbin.com/)

Στιγμιότυπο οθόνης ταχυδρόμος
Εικόνα 1 Στιγμιότυπο οθόνης Ταχυδρόμος

API

Τρέχουσα ΟΗΕweb παρέχει το ακόλουθο API HTTP για UNNext. https://isdweb.deltaww.com/api/getUnoNextPeriod

Ο πίνακας 3 λαμβάνει Uno Next Period Usage

API Πρωτόκολλο Περιγραφή
getUnoNextPeriod ΘΕΣΗ Λάβετε δεδομένα UNonext με βάση τα δεδομένα κινούμενου μέσου όρου.
Εξουσιοδότηση: Bearer Token (Στην κεφαλίδα αιτήματος HTTP)
Διακριτικό χρήστη: Κάθε Σχήμα και διάταξις βιβλίου Ο χρήστης έχει ένα μοναδικό διακριτικό. Το μήκος είναι 32.

 

Φορέας xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Φορέας Π.χ
Κύριο μέρος της ανάρτησης (μορφή JSON)
{

“sn”: “2040N00F0116”,

"αισθητήρας": μηδενικό,

"rtData": [],

"dataFormat": "dict",

"tsRange": null

}

Περιγραφή κλειδιού JSON

Κλειδί Περιγραφή
sn SN του ανήκε UNNext.
αισθητήρας Μετακίνηση μέσος. δεδομένα της διάταξης συμβολοσειρών αισθητήρων. άκυρος σημαίνει όλος αισθητήρας. Κενός πίνακας [] σημαίνει ότι δεν ενδιαφερόμαστε κινούμενο μέσο. δεδομένα.
rtData Δεδομένα σε πραγματικό χρόνο της διάταξης συμβολοσειρών αισθητήρων. άκυρος σημαίνει ότι δεν υπάρχουν ενδιαφέροντα δεδομένα σε πραγματικό χρόνο. Κενός πίνακας [] σημαίνει όλα τα δεδομένα αισθητήρα.
Μορφή δεδομένων Αποδοχή "dict", "csv", "json". Χρησιμοποιήστε το "dict" για τις περισσότερες περιπτώσεις.
tsΕύρος εποχή εποχής αγamp πίνακας. [έναρξη, τέλος] – [1613633000, 1613633201] άκυρος σημαίνει τα τελευταία δεδομένα σε 1 ώρα. Εποχή Εξample: https://www.epochconverter.com/
Απόκριση (εφαρμογή/json) 
{
"αποτέλεσμα": "SUC",
"ωφέλιμο φορτίο": {
"στήλες": [
"χρόνος",
"ΘΕΡΜΟΚΡΑΣΙΑ",
“HUMI”,
“LUX”,
"NTC",
«TVOC»,
"HCHO",
“CO”,
«CO2»,
"O3",
"PM2p5",
“PM10”,
"TEMP_F",
"NTC_F"
],
«δεδομένα»: [
[
1619425800,
23.2,
67.57,
282,
άκυρος,
30000,
42,
0,
920,
0,
2,
1,
73.76,
άκυρος
] ] },
"rawCount": 1,
«μέτρηση»: 1
}

Περιγραφή κλειδιού JSON

Κλειδί Περιγραφή
αποτέλεσμα

Το "SUC" είναι ΕΠΙΤΥΧΗΣ.

Τα "FAIL" και "ERR" επιστρέφουν με μήνυμα σφάλματος.

ωφέλιμο φορτίο.στήλες

Στήλη αισθητήρα που παρουσιάζεται με ανταπόκριση. Ο «χρόνος» είναι εποχή αγamp. Άλλα μπορούν να βρεθούν στον Πίνακα 1 και στον Πίνακα 2

ωφέλιμο φορτίο.δεδομένα Απάντηση ένθετη συστοιχία δεδομένων, κάθε στοιχείο είναι συστοιχία αντίστοιχες στήλες αισθητήρα. άκυρος σημαίνει ότι δεν υπάρχουν δεδομένα αυτή τη στιγμή stamp, αποσυναρμολογημένος ή μη φυσιολογικός αισθητήρας.
κόμης

Εάν το "αποτέλεσμα" είναι "SUC", το "count" παρουσιάζει το μήκος των έγκυρων δεδομένων (όχι όλα άκυρος δεδομένα) πίνακα.

rawCount

Εάν το "αποτέλεσμα" είναι "SUC", το "count" παρουσιάζει το μήκος των δεδομένων (περιέχει όλα άκυρος δεδομένα) πίνακα.

 

 

Έγγραφα / Πόροι

Λογισμικό DELTA HTTP API [pdf] Εγχειρίδιο χρήστη
Λογισμικό HTTP API, HTTP API, Λογισμικό

Αναφορές

Αφήστε ένα σχόλιο

Η διεύθυνση email σας δεν θα δημοσιευτεί. Τα υποχρεωτικά πεδία επισημαίνονται *