Πώς να χρησιμοποιήσετε το IAMMETER-cloud πιο αποτελεσματικά από το API

Προϋπόθεση

Το IAMMETER-cloud παρέχει ορισμένα API και ο προγραμματιστής μπορεί να χρησιμοποιήσει αυτά τα API για να κάνει κάποια ενδιαφέρουσα εργασία, όπως η ενσωμάτωση των δεδομένων του IAMMETER σε κάποιο σύστημα τρίτου κατασκευαστή. Μόλις ανοίξαμε αυτά τα API στους επιχειρηματικούς μας συνεργάτες και σε ορισμένους μεγάλους πελάτες στο παρελθόν, αλλά αποφασίσαμε να τα ανοίξουμε σε όλους τους πελάτες μας τώρα.

Καλώς ήρθατε να μας πείτε τη γνώμη σας στο φόρουμ μας.https://imeter.club

Όριο στο API

Δεν είναι δυνατή η απεριόριστη επίσκεψη στο API, θα περιορίσουμε τον ημερήσιο αριθμό κλήσεων για κάθε API. Μην καλείτε το API πιο συχνά.

Εάν ο αριθμός των κλήσεων υπερβαίνει τον ωριαίο ή ημερήσιο περιορισμό, το API δεν θα επιστρέψει τίποτα.

Λάβετε το διακριτικό του λογαριασμού

Επιστρέψτε το διακριτικό του λογαριασμού. Το διακριτικό θα χρησιμοποιηθεί σχεδόν σε όλα τα API.

Δεν χρειάζεται να καλέσετε αυτό το API εκτός και αν θέλετε να ανανεώσετε το διακριτικό.Μην καλείτε αυτό το API περισσότερες από 5 φορές σε μία ώρα και όχι περισσότερες από 30 φορές σε μία ημέρα.

URL&Μέθοδος

Αποκτήστε το διακριτικό του λογαριασμού που χρησιμοποιείται σε όλα τα API.

URL:https://www.iammeter.com/api/v1/user/login

Μέθοδος:Θέση

Δεδομένα

Απάντηση

Η τιμή του διακριτικού θα χρησιμοποιηθεί σε όλα τα παρακάτω API.

{
    "δεδομένα": {
        "id": 2025,
        "token": "349dfxxxxxxac5169",
        "refreshToken": "8adf75e5da10424985f3b83855133982"
    },
    "επιτυχής": αλήθεια,
    "μήνυμα": null
}

Λάβετε το διακριτικό απευθείας από το σύστημα web

Αυτό το διακριτικό μπορεί επίσης να διαβαστεί απευθείας αφού συνδεθείτε στο σύστημα.

Λάβετε τα πιο πρόσφατα δεδομένα μεταφόρτωσης και την ώρα UTC

Λάβετε τα τελευταία δεδομένα μεταφόρτωσης με το αντίστοιχο SN.

Μην καλείτε αυτό το API περισσότερες από 12 φορές σε μία ώρα.

URL&Μέθοδος

Βασικά (μετρικά δεδομένα): https://www.iammeter.com/api/v1/site/meterdata/{sn}

Σύνθετες (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}

Μέθοδος: ΠΑΡΕ

Οριο: μην ζητάτε αυτό το API περισσότερες από 288 φορές κάθε μέρα (διάστημα 5 λεπτών).

Η διαφορά μεταξύ βασικού και προχωρημένου:

Βασικό: χωρίς PF (Συντελεστής ισχύος)

Προηγμένο: με PF (Συντελεστής ισχύος)

Παράμετροι

Απόκριση: μονοφασικά -μετρικά δεδομένα (χωρίς συντελεστή ισχύος)

ορισμός τιμών: τάση, ρεύμα, ενεργός ισχύς, εισαγόμενη Kwh, εξαγόμενη Kwh

{
    "δεδομένα": {
        "αξίες": [
            [
                230.220,
                1.300,
                119.000,
                1766.590,
                0.000
            ]
        ],
        "τοπική ώρα": "2020/8/28 15:27:33",
        "gmtTime": "28/8/2020 5:27:33"
    },
    "επιτυχής": αλήθεια,
    "μήνυμα": null
}

Απόκριση: μονοφασική -meterdata2 (χωρίς συντελεστή ισχύος)

ορισμός τιμών: τάση, ρεύμα, ενεργή ισχύς,συντελεστής ισχύος,εισαγόμενη Kwh, εξαγόμενη Kwh

{
    "δεδομένα":{
        "αξίες":[
            [
                233,41,
                0,718,
                111,
                0,66,
                5724,85,
                0
            ]
        ],
        "τοπική ώρα":"2023/11/21 14:30:22",
        "gmtTime":"2023/11/21 6:30:22"
    },
    "επιτυχημένο":true,
    "μήνυμα":null
}

Απόκριση: Δεδομένα 3 φάσεων (χωρίς συντελεστή ισχύος)

Οι τρεις συστοιχίες μέσααξίεςαντιπροσωπεύουν τη φάση Α, τη φάση Β και τη φάση Γ.

Ορισμός στοιχείου: τάση, ρεύμα, ενεργός ισχύς,συντελεστής ισχύος,εισαγόμενη Kwh, εξαγόμενη Kwh

{
    "δεδομένα": {
        "αξίες": [
            [
                242.600,
                1.000,
                216.000,
                32354.600,
                0.000
            ],
            [
                242.600,
                1.000,
                1986.000,
                30536.410,
                17704.720
            ],
            [
                0.000,
                0.000,
                0.000,
                0.000,
                0.000
            ]
        ],
        "τοπική ώρα": "28/8/2020 15:30:48",
        "gmtTime": "28/8/2020 5:30:48"
    },
    "επιτυχής": αλήθεια,
    "μήνυμα": null
}

Απόκριση: 3 φάση -meterdata2 (με συντελεστή ισχύος)

{
    "δεδομένα":{
        "αξίες":[
            [//φάση Α
                233,8,//τάση
                0,03,//τρέχον
                4,//ενεργή ισχύς
                0,57,//συντελεστής ισχύος
                222,53,//εισαγόμενη Kwh
                0 //εξαγόμενη Kwh
            ],
            [//φάση Β
                5,
                0,
                0,
                0,
                0,
                0
            ],
            [ //φάση Γ
                3.1,
                0,
                0,
                0,
                0,
                0
            ]
        ],
        "τοπική ώρα":"2023/11/21 14:39:36",
        "gmtTime":"2023/11/21 6:39:36"
    },
    "επιτυχημένο":true,
    "μήνυμα":null
}

Παράδειγμα

Αποκτήστε το ρεκόρ ιστορίας

Επιστρέψτε τα δεδομένα ιστορικού στο καθορισμένο διάστημα και χρονικό εύρος.

• εύρος χρόνου: τελευταίος μήνας
• μέγιστο μήκος δεδομένων: 2000 τεμάχια

Τα στιγμιαία δεδομένα είναι σε διάστημα 1 λεπτού. Υπάρχουν 60*24=1440 δεδομένα την ημέρα. Εάν ζητήσετε τα δεδομένα ιστορικού σε διάστημα 1 λεπτού, μπορείτε να ζητήσετε μόνο τα δεδομένα 1,39 (2000/1440) ημερών. Αλλά αν ζητήσετε τα δεδομένα σε διάστημα 5 λεπτών, μπορείτε να ζητήσετε τα δεδομένα σχεδόν 7 ημερών.

URL&Μέθοδος

Βασικός (μετρομετρητής):https://www.iammeter.com/api/v1/site/meterdatalist/

**Για προχωρημένους(meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}

Η διαφορά μεταξύ βασικού και προχωρημένου:

Βασικό: χωρίς PF (Συντελεστής ισχύος)

Προηγμένο: με PF (Συντελεστής ισχύος)

Παράμετροι

Απάντηση: μονοφασική - μετροδοτικός

Δεδομένα: [τάση, ρεύμα, ισχύς, εισαγωγή ενέργειας, εξαγωγή ενέργειας, ώρα utc, τοπική ώρα]

{
    "δεδομένα": [
        [
            227,73,
            1,45,
            172,
            13121,56,
            0,
            "2023/9/12 0:00:34",
            "2023/9/11 14:00:34"
        ],
        [
            229,43,
            1,45,
            172,
            13121,56,
            0,
            "2023/9/12 0:01:33",
            "2023/9/11 14:01:33"
        ]
    ],
    "επιτυχής": αλήθεια,
    "μήνυμα": null
}

Απάντηση: τριφασική - μετροδοτικός

{
    "δεδομένα": [
        [
            230,//phaseA τάση
            0,//τρέχον
            0,//ενεργή ισχύς
            468,41,//εισαγόμενη kWh
            0,//εξαγόμενη kWh
            230,//Φάση Β
            0,
            0,
            236,58,
            290,77,
            230,//Φάση Γ
            0,
            0,
            258,62,
            0,
            "2023/9/12 0:00:15",
            "2023/9/11 16:00:15"
        ],
        [
            230,
            0,
            0,
            468,41,
            0,
            230,
            0,
            0,
            236,58,
            290,77,
            230,
            0,
            0,
            258,62,
            0,
            "2023/9/12 0:02:08",
            "2023/9/11 16:02:08"
        ]
    ],
    "επιτυχής": αλήθεια,
    "μήνυμα": null
}

Απόκριση: τριφασική - μετροδοτικός2

{
    "δεδομένα":[
        {//πρώτα δεδομένα
            "rtcTime":"2023/9/1 0:00:22",
            "gmtTime":"2023/8/31 16:00:22",
            "αξίες":[
                [ //φάση Α
                    235,2,//τάση
                    0,03,//τρέχον
                    4,//ενεργή ισχύς
                    0,57,//συντελεστής ισχύος
                    210,21,//εισαγωγή Kwh
                    0 //εξαγόμενη Kwh
                ],
                [//φάση Β
                    5.5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [ //φάση Γ
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        { //δεύτερο δεδομένα
            "rtcTime":"2023/9/1 8:00:49",
            "gmtTime":"2023/9/1 0:00:49",
            "αξίες":[
                [
                    233,4,
                    0,03,
                    4,
                    0,57,
                    210.24,
                    0
                ],
                [
                    5.4,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        {//τρίτα δεδομένα
            "rtcTime":"2023/9/1 16:00:24",
            "gmtTime":"2023/9/1 8:00:24",
            "αξίες":[
                [
                    235,6,
                    0,03,
                    4,
                    0,57,
                    210.27,
                    0
                ],
                [
                    5.5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [
                    3.4,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        }
    ],
    "επιτυχημένο":true,
    "μήνυμα":null
}

Παράδειγμα

https://www.iammeter.com/api/v1/Site/MeterDataList/{yourSN}?token={yourToken}&startTime=2023-09-01&endTime=2023-09-07&interval=300

Ανάλυση ισχύος ανάγνωσης

Επιστρέψτε το αποτέλεσμα της ανάλυσης ισχύος στον καθορισμένο χρόνο.

Μην καλείτε αυτό το API περισσότερες από 5 φορές σε μία ημέρα.

URL&Μέθοδος

URL:https://www.iammeter.com/api/v1/site/powerAnalysis

Μέθοδος: πάρε

Οριο: Μην ζητάτε αυτό το API ανά SN περισσότερες από 5 φορές την ημέρα.

Παράμετροι

Σημείωση:

1. Το μέγιστο χρονικό εύρος είναι 7 ημέρες τον τελευταίο μήνα.
2. Η παράμετρος χρόνου είναι προαιρετική, εάν δεν χρησιμοποιήσετε την παράμετρο, το API θα επιστρέψει το αποτέλεσμα των τελευταίων 7 ημερών.

Απάντηση

μέσος όρος: μέση ένδειξη ισχύος κατά τη διάρκεια αυτού του χρονικού εύρους.

μέσος όροςΗμέρα: μέση ένδειξη ισχύος κατά τη διάρκεια της ημέρας (8:00 π.μ.-8:00 μ.μ.) σε αυτό το χρονικό εύρος.

ελάχιστη: ελάχιστη ένδειξη ισχύος κατά τη διάρκεια αυτού του χρονικού εύρους.

μέγιστη: μέγιστη ένδειξη ισχύος κατά τη διάρκεια αυτού του χρονικού εύρους.

{
    "δεδομένα": {
        "Ώρα έναρξης": "01-09-2023",
        "Ώρα λήξης": "07-09-2023",
        "μέσος όρος": 862,6,
        "μέσος όρος ημέρας": 836,9,
        "ελάχιστο": 259,0,
        "μέγιστο": 3999,0
    },
    "επιτυχής": αλήθεια,
    "μήνυμα": null
}

Παράδειγμα

Επιστρέψτε το αποτέλεσμα ανάλυσης ισχύος των τελευταίων 7 ημερών.

Επιστρέψτε το αποτέλεσμα ανάλυσης ισχύος της καθορισμένης ημέρας

https://www.iammeter.com/api/v1/site/powerAnalysis?token={YourToken}&sn={YourSN}&starttime=2023-09-21&endtime=2023-09-21

Ανάλυση κατάστασης εκτός σύνδεσης

Επιστρέψτε την κατάσταση αποσύνδεσης με το θεωρούμενο SN στον καθορισμένο χρόνο.

Μην καλείτε αυτό το API περισσότερες από 5 φορές σε μία ημέρα.

URL&Μέθοδος

URL：https://www.iammeter.com/api/v1/site/offlineAnalysis

Μέθοδος：Παίρνω

Οριο: Μην ζητάτε αυτό το API ανά SN περισσότερες από 5 φορές την ημέρα.

Παράμετροι

Σημείωση:

1. Το μέγιστο χρονικό εύρος είναι 7 ημέρες τον τελευταίο μήνα.
2. Η παράμετρος χρόνου είναι προαιρετική, εάν δεν χρησιμοποιήσετε την παράμετρο, το API θα επιστρέψει το αποτέλεσμα των τελευταίων 7 ημερών.
3. Εάν δεν καθορίσετε το διάστημα, η προεπιλογή είναι 5 λεπτά.

Απάντηση

Υπάρχουν συνολικά 10080 λεπτά σε αυτό το χρονικό εύρος.

Ο συνολικός χρόνος εκτός σύνδεσης είναι 906 λεπτά σε αυτό το χρονικό εύρος.

Το κενό εκτός σύνδεσης που είναι μεγαλύτερο από 5 λεπτά παρατίθεται στον πίνακα.

{
    "δεδομένα": {
        "Ώρα έναρξης": "05-09-2023",
        "Ώρα λήξης": "11-09-2023",
        "Αριθμός εκτός σύνδεσης": 906,
        "totalCount": 10080,
        "λίστα": [
            {
                "Ώρα έναρξης": "2023/9/5 0:00:00",
                "Ώρα λήξης": "5/9/2023 15:06:14",
                "διάρκεια": 906
            }
        ]
    },
    "επιτυχής": αλήθεια,
    "μήνυμα": null
}

Παράδειγμα

Επιστρέψτε το αποτέλεσμα της ανάλυσης εκτός σύνδεσης της καθορισμένης ημέρας

https://www.iammeter.com/api/v1/site/offlineAnalysis?token={YourToken}&sn={YourSN}&starttime=2023-09-21&endtime=2023-09-21

Αναφορά

API του μετρητή ενέργειας WiFi

Τριφασικός μετρητής ενέργειας WiFi

Χρησιμοποιήστε τον μετρητή ενέργειας 3 φάσεων με τον τρόπο που προτιμάτε