Αυτό το άρθρο γίνεται ανάλυση της δομής του API που προσφέρει την δυνατότητα εισαγωγής μετρήσεων από αισθητήρες στην πλατφόρμα του AgroBox.gr
Δεν έχετε API KEY? ΕΓΓΡΑΦΗ ΓΙΑ ΠΡΟΓΡΑΜΜΑΤΙΣΤΕΣ
URL API: https://app.agrobox.gr/gsmbox.php
Μέθοδος αιτήματος: POST
Παράμετροι κλήσης API
| Παράμετρος | Περιγραφή | Απαιτείται | Τύπος δεδομένων |
Αρχική τιμή |
| key | User API Key | ναι | Αλφαριθμητικό | |
| boxkey | GSM BOX Key | ναι | Αλφαριθμητικό | |
| format | Response format | οχι | Αλφαριθμητικό (json ή query) | json |
| task | API action | οχι | Αλφαριθμητικό | addmetric |
| stype | Sensor Data | ναι | πίνακας σε μορφή http | |
| vbat | Battery Level | οχι | ακέραιος (1-100) | |
| signal | Signal Level | οχι | ακέραιος (1-100) | |
| simnumber | Sim Card Number | οχι | Αλφαριθμητικό(15) | |
| version | Version of software | οχι | Αλφαριθμητικό (format 1.0.0) |
Τύποι μετρήσεων / Sensor Types (stype)
| Αριθμός Αισθητήρα |
Περιγραφή |
| 1 | ΘΕΡΜΟΚΡΑΣΙΑ ΑΕΡΑ (Μονάδα Celcius) (ελάχιστη -50, μέγιστη 60) |
| 2 | ΥΓΡΑΣΙΑ ΑΕΡΑ (Μονάδα %) (ελάχιστη 0, μέγιστη 100) |
| 3 | ΘΕΡΜΟΚΡΑΣΙΑ ΕΔΑΦΟΥΣ (Μονάδα Celcius) (ελάχιστη -50, μέγιστη 60) |
| 4 | ΥΓΡΑΣΙΑ ΕΔΑΦΟΥΣ (Μονάδα %) (ελάχιστη 0, μέγιστη 100) |
| 5 | ΝΕΦΟΚΑΛΥΨΗ % (ελάχιστη 0, μέγιστη 100) |
| 6 | ΑΤΜΟΣΦΑΙΡΙΚΗ ΠΙΕΣΗ kPa (ελάχιστη 500, μέγιστη 1100) |
| 7 | ΥΓΡΑΣΙΑ ΦΥΛΛΩΜΑΤΟΣ (Μονάδα %) (ελάχιστη 0, μέγιστη 100) |
| 8 | RADIATION Watt/mm2 (ελάχιστη 0, μέγιστη 1800) |
| 9 | WIND Km/hour (ελάχιστη 0, μέγιστη 200) |
| 10 | RAIN LEVEL mm (ελάχιστη 0, μέγιστη 2000) |
| 11 | Ph (ελάχιστη 0, μέγιστη 14) |
| 12 | EC (mS/cm) |
| 13 |
ΘΕΡΜΟΚΡΑΣΙΑ ΦΥΛΛΩΜΑΤΟΣ (Μονάδα Celcius) (ελάχιστη -50, μέγιστη 60) |
Δομή σώματος κλήσης / Body Request
key=USER_API_KEY&boxkey=GSM_BOX_KEY&stype[N1]=N1_V1,N1_V2&stype[N2]=N2_V1&vbat=VBAT_LEVEL&format=json
Παράδειγμα
Θερμοκρασία & Υγρασία αέρα (μια τιμή ανά αισθητήρα)
key=abd123xxxxxxx&boxkey=12sdsd12&stype[1]=20.30&stype[2]=70&vbat=80&signal=63
Μπορείτε να στείλετε πολλαπλές τιμές ανά αισθητήρα αρκεί να τις χωρίσετε με κόμμα (,).
Παράδειγμα: 2 αισθητήρες θερμοκρασίας, και 2 αισθητήρες υγρασίας. Τα δεκαδικά ψηφία χωρίζονται με τελεία (.)
key=abd123xxxxxxx&boxkey=12sdsd12&stype[1]=20.30,18.93&stype[2]=70,76
Διατηρήστε την σειρά αποστολής τιμών, σε περίπτωση που κάποιος απ τους αισθητήρες σας δεν μπορεί να διαβάσει τιμές περιβάλλοντος. Για να κρατήσετε την ίδια σειρά, είτε θα την αφήσετε κενή είτε θα συμπεριλάβετε την λέξη "false" . Για παράδειγμα ο 1ος αισθητήρας θερμοκρασίας δεν λειτουργεί:
key=abd123xxxxxxx&boxkey=12sdsd12&stype[1]=false,18.93&stype[2]=70,76
REST API CLIENT (Firefox)
