So nutzen Sie IAMMETER-cloud effizienter durch die API

Prämisse

IAMMETER-cloud stellt einige APIs bereit, und der Entwickler kann diese APIs verwenden, um einige interessante Arbeiten durchzuführen, beispielsweise die Integration der Daten von IAMMETER in ein Drittsystem. Wir haben diese APIs zuvor nur für unsere Geschäftspartner und einige Großkunden geöffnet, haben uns aber entschieden, sie jetzt für alle unsere Kunden zu öffnen.

Teilen Sie uns gerne Ihre Meinung in unserem Forum mit.https://imeter.club

Beschränkung der API

Die API kann nicht unbegrenzt besucht werden. Wir begrenzen die tägliche Aufrufanzahl für jede API. Bitte rufen Sie die API nicht häufiger auf.

Wenn die Anzahl der Anrufe das stündliche oder tägliche Limit überschreitet, gibt die API nichts zurück.

Holen Sie sich den Token des Kontos

Geben Sie den Token des Kontos zurück. Der Token wird in fast allen APIs verwendet.

Sie müssen diese API nicht aufrufen, es sei denn, Sie möchten das Token aktualisieren.Bitte rufen Sie diese API nicht mehr als 5 Mal pro Stunde und nicht mehr als 30 Mal pro Tag auf.

URL&Methode

Rufen Sie das Token des Kontos ab, das in allen APIs verwendet wird.

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

Methode:Post

Daten

Antwort

Der Tokenwert wird in allen folgenden APIs verwendet.

{
    "Daten": {
        "ID": 2025,
        "Token": "349dfxxxxxxac5169",
        "refreshToken": "8adf75e5da10424985f3b83855133982"
    },
    "erfolgreich": wahr,
    "Nachricht": null
}

Holen Sie sich das Token direkt vom Websystem

Dieser Token kann auch direkt nach der Anmeldung am System ausgelesen werden.

Erhalten Sie die neuesten Upload-Daten und die UTC-Zeit

Holen Sie sich die letzten Upload-Daten mit der entsprechenden SN.

Bitte rufen Sie diese API nicht mehr als 12 Mal pro Stunde auf.

URL&Methode

Basic(Zählerdaten): https://www.iammeter.com/api/v1/site/meterdata/{sn}

Erweitert (Meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}

Methode: ERHALTEN

Grenze: Bitte fordern Sie diese API nicht mehr als 288 Mal pro Tag an (5-Minuten-Intervall).

Der Unterschied zwischen Basic und Advanced:

Basic: ohne PF (Leistungsfaktor)

Erweitert: mit PF (Leistungsfaktor)

Parameter

Antwort: Einphasen-Zählerdaten (ohne Leistungsfaktor)

Wertedefinition: Spannung, Strom, Wirkleistung, importierte kWh, exportierte kWh

{
    "Daten": {
        "Werte": [
            [
                230.220,
                1.300,
                119.000,
                1766.590,
                0,000
            ]
        ],
        "localTime": "28.08.2020 15:27:33",
        "gmtTime": "28.08.2020 5:27:33"
    },
    "erfolgreich": wahr,
    "Nachricht": null
}

Antwort: einphasig -meterdata2 (ohne Leistungsfaktor)

Wertedefinition: Spannung, Strom, Wirkleistung,Leistungsfaktor,importierte kWh, exportierte kWh

{
    "Daten":{
        "Werte":[
            [
                233,41,
                0,718,
                111,
                0,66,
                5724,85,
                0
            ]
        ],
        "localTime":"21.11.2023 14:30:22",
        "gmtTime":"21.11.2023 6:30:22"
    },
    "erfolgreich":true,
    "Nachricht":null
}

Antwort: 3-Phasen-Zählerdaten (ohne Leistungsfaktor)

Die drei Arrays inWerterepräsentieren Phase A, Phase B und Phase C.

Elementdefinition: Spannung, Strom, Wirkleistung,Leistungsfaktor,importierte kWh, exportierte kWh

{
    "Daten": {
        "Werte": [
            [
                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
            ]
        ],
        "localTime": "28.08.2020 15:30:48",
        "gmtTime": "28.08.2020 5:30:48"
    },
    "erfolgreich": wahr,
    "Nachricht": null
}

Antwort: 3 Phasen -meterdata2 (mit Leistungsfaktor)

{
    "Daten":{
        "Werte":[
            [//Phase A
                233,8,//Spannung
                0,03,//Strom
                4,//Wirkleistung
                0,57,//Leistungsfaktor
                222,53,//importierte kWh
                0 //exportierte kWh
            ],
            [//Phase B
                5,
                0,
                0,
                0,
                0,
                0
            ],
            [ //Phase C
                3.1,
                0,
                0,
                0,
                0,
                0
            ]
        ],
        "localTime":"21.11.2023 14:39:36",
        "gmtTime":"21.11.2023 6:39:36"
    },
    "erfolgreich":true,
    "Nachricht":null
}

Beispiel

Holen Sie sich den Verlaufsdatensatz

Geben Sie die historischen Daten im festgelegten Intervall und Zeitbereich zurück.

• Zeitbereich: letzter Monat
• maximale Datenlänge: 2000 Stück

Die Sofortdaten liegen im 1-Minuten-Intervall vor. Es gibt 60*24=1440 Daten pro Tag. Wenn Sie die historischen Daten im 1-Minuten-Intervall anfordern, können Sie nur die Daten von 1,39 (2000/1440) Tagen anfordern. Wenn Sie die Daten jedoch im 5-Minuten-Intervall anfordern, können Sie die Daten von fast 7 Tagen anfordern.

URL&Methode

Basic(Meterdatenliste):https://www.iammeter.com/api/v1/site/meterdatalist/

**Erweitert(meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}

Der Unterschied zwischen Basic und Advanced:

Basic: ohne PF (Leistungsfaktor)

Erweitert: mit PF (Leistungsfaktor)

Parameter

Antwort: einphasig – Zählerdatenliste

Daten:[Spannung, Strom, Leistung, Energie importieren, Energie exportieren, UTC-Zeit, Ortszeit]

{
    "Daten": [
        [
            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“
        ]
    ],
    "erfolgreich": wahr,
    "Nachricht": null
}

Antwort: dreiphasig – Meterdatalist

{
    "Daten": [
        [
            230,//PhaseA-Spannung
            0,//aktuell
            0,//Wirkleistung
            468,41,//importierte kWh
            0,//exportierte kWh
            230,//PhaseB
            0,
            0,
            236,58,
            290,77,
            230,//Phase C
            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“
        ]
    ],
    "erfolgreich": wahr,
    "Nachricht": null
}

Antwort: dreiphasig – meterdatalist2

{
    "Daten":[
        { //erste Daten
            "rtcTime":"2023/9/1 0:00:22",
            "gmtTime":"2023/8/31 16:00:22",
            "Werte":[
                [ //Phase A
                    235,2,//Spannung
                    0,03,//Strom
                    4,//Wirkleistung
                    0,57,//Leistungsfaktor
                    210,21,//kwh importieren
                    0 //exportierte kWh
                ],
                [//Phase B
                    5,5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [ //Phase C
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        { //zweite Daten
            "rtcTime":"2023/9/1 8:00:49",
            "gmtTime":"2023/9/1 0:00:49",
            "Werte":[
                [
                    233,4,
                    0,03,
                    4,
                    0,57,
                    210,24,
                    0
                ],
                [
                    5.4,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        { //dritte Daten
            "rtcTime":"2023/9/1 16:00:24",
            "gmtTime":"2023/9/1 8:00:24",
            "Werte":[
                [
                    235,6,
                    0,03,
                    4,
                    0,57,
                    210,27,
                    0
                ],
                [
                    5,5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [
                    3.4,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        }
    ],
    "erfolgreich":true,
    "Nachricht":null
}

Beispiel

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

Power-Reading-Analyse

Geben Sie das Ergebnis der Leistungsanalyse in der angegebenen Zeit zurück.

Bitte rufen Sie diese API nicht mehr als fünfmal am Tag auf.

URL&Methode

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

Methode: erhalten

Grenze: Bitte fordern Sie diese API pro SN nicht mehr als fünfmal am Tag an.

Parameter

Notiz:

1. Der maximale Zeitraum beträgt 7 Tage im letzten Monat.
2. Der Zeitparameter ist optional. Wenn Sie den Parameter nicht verwenden, gibt die API das Ergebnis der letzten 7 Tage zurück.

Antwort

Durchschnitt: durchschnittlicher Leistungswert während dieses Zeitraums.

AverageDaytime: durchschnittlicher Leistungsmesswert tagsüber (8:00–20:00 Uhr) in diesem Zeitraum.

Minimum: minimaler Leistungsmesswert während dieses Zeitraums.

Maximum: Maximaler Leistungsmesswert während dieses Zeitbereichs.

{
    "Daten": {
        „startTime“: „2023-09-01“,
        „endTime“: „2023-09-07“,
        „Durchschnitt“: 862,6,
        "averageDaytime": 836,9,
        "Minimum": 259,0,
        "Maximum": 3999,0
    },
    "erfolgreich": wahr,
    "Nachricht": null
}

Beispiel

Geben Sie das Ergebnis der Leistungsanalyse der letzten 7 Tage zurück.

Gibt das Ergebnis der Leistungsanalyse des angegebenen Tages zurück

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

Offline-Statusanalyse

Geben Sie den Trennungsstatus mit der betrachteten SN in der angegebenen Zeit zurück.

Bitte rufen Sie diese API nicht mehr als fünfmal am Tag auf.

URL&Methode

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

Methode：Erhalten

Grenze: Bitte fordern Sie diese API pro SN nicht mehr als fünfmal am Tag an.

Parameter

Notiz:

1. Der maximale Zeitraum beträgt 7 Tage im letzten Monat.
2. Der Zeitparameter ist optional. Wenn Sie den Parameter nicht verwenden, gibt die API das Ergebnis der letzten 7 Tage zurück.
3. Wenn Sie das Intervall nicht angeben, beträgt der Standardwert 5 Minuten.

Antwort

In diesem Zeitbereich gibt es insgesamt 10080 Minuten.

Die gesamte Offlinezeit beträgt in diesem Zeitraum 906 Minuten.

Die Offline-Lücke, die mehr als 5 Minuten beträgt, wird im Array aufgeführt.

{
    "Daten": {
        „startTime“: „2023-09-05“,
        „endTime“: „2023-09-11“,
        "offlineCount": 906,
        "totalCount": 10080,
        "Liste": [
            {
                "startTime": "2023/9/5 0:00:00",
                "endTime": "2023/9/5 15:06:14",
                "Dauer": 906
            }
        ]
    },
    "erfolgreich": wahr,
    "Nachricht": null
}

Beispiel

Gibt das Offline-Analyseergebnis des angegebenen Tages zurück

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

Referenz

API des WLAN-Energiezählers

3-Phasen-WLAN-Energiezähler

Verwenden Sie den 3-Phasen-Energiezähler so, wie Sie es bevorzugen