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
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.
| Nein. | API | Limittyp | stündlich | Täglich | Beschreibung |
|---|---|---|---|---|---|
| 1 | /Benutzer-Anmeldung | IP | 5 | 30 | Eine IP darf diese API nur fünfmal pro Stunde aufrufen |
| 2 | /site/meterdata/ | SN | 12 | Ein SN darf diese API nur 12 Mal pro Stunde aufrufen | |
| 3 | /site/powerAnalysis | SN | 5 | Ein SN darf diese API nur fünfmal täglich aufrufen | |
| 4 | /site/offlineAnalysis | SN | 5 | Ein SN darf diese API nur fünfmal täglich aufrufen |
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.
Rufen Sie das Token des Kontos ab, das in allen APIs verwendet wird.
URL:https://www.iammeter.com/api/v1/user/login
Methode:Post
| Nein. | Parameter | Anmerkung | Beispiel |
|---|---|---|---|
| 1 | Nutzername | Benutzername von IAMMETER | prüfen |
| 2 | Passwort | Passwort von IAMMETER | 123456 |
Der Tokenwert wird in allen folgenden APIs verwendet.
{
"Daten": {
"ID": 2025,
"Token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"erfolgreich": wahr,
"Nachricht": null
}Dieser Token kann auch direkt nach der Anmeldung am System ausgelesen werden.
Holen Sie sich die letzten Upload-Daten mit der entsprechenden SN.
Bitte rufen Sie diese API nicht mehr als 12 Mal pro Stunde auf.
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)
| Name | Typ | Beispiel | |
|---|---|---|---|
| Zeichen | Zeichenfolge | xxx | erforderlich |
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
}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
}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
}{
"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
}
Geben Sie die historischen Daten im festgelegten Intervall und Zeitbereich zurü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.
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)
| Name | Typ | Beispiel | |
|---|---|---|---|
| Zeichen | Zeichenfolge | xxx | erforderlich |
| Intervall | Nummer | 300 | erforderlich, Einheit: Sekunde |
| Startzeit | Schnur | 2023-09-01 | erforderlich |
| Endzeit | Schnur | 2023-09-07 | erforderlich |
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
}{
"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
}{
"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
}
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: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.
| Name | Typ | Beispiel | |
|---|---|---|---|
sn |
Zeichenfolge | xxx | erforderlich |
Startzeit |
Zeichenfolge | 2023-09-01 | Optional |
Endzeit |
Zeichenfolge | 2023-09-07 | Optional |
Notiz:
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
}Geben Sie das Ergebnis der Leistungsanalyse der letzten 7 Tage zurück.
Gibt das Ergebnis der Leistungsanalyse des angegebenen Tages zurück
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：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.
| Name | Typ | Beispiel | |
|---|---|---|---|
sn |
Zeichenfolge | xxxx | erforderlich |
Startzeit |
Zeichenfolge | 2023-09-01 | Optional |
Endzeit |
Zeichenfolge | 2023-09-07 | Optional |
Intervall(Einheit: Minute) |
Nummer | 5 | Optional |
Notiz:
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
}Gibt das Offline-Analyseergebnis des angegebenen Tages zurück
Gibt den neuesten Wert aller Energiezähler in diesem Konto zurück.
URL：https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Methode：Erhalten
Grenze: Bitte stellen Sie sicher, dass Sie nicht häufiger als alle 5 Minuten Anfragen an diese API stellen.
| Name | Typ | Beispiel | |
|---|---|---|---|
| Zeichen | Zeichenfolge | xxx | erforderlich |
{
„Daten“:[
{
„sn“: „DA2BED94“,
„Werte“:[
223,71,
1,74,
225,
14761,03,
0
],
„gmtTime“: „22.02.2024 3:46:20“
},
{
„sn“: „B384789C“,
„Werte“: [
[
248,9,
13,9,
3356,
21228,
0,
null,
null
],
[
248,9,
13,9,
-2747,
8988,48,
18489,44,
null,
null
],
[
null,
null,
null,
null,
null,
null,
null
],
[
248,9,
13,9,
-2747,
8988,48,
18489,44,
null,
null
]
],
„gmtTime“: „22.02.2024 3:45:15“
},
{
„sn“: „674B1E5D“,
„Werte“: [
[
220,4,
1,86,
377,
5345,985,
20,565
],
[
220,4,
1,86,
377,
5367,715,
0,033
],
[
220,5,
1,86,
377,
5369,532,
0,033
]
],
„gmtTime“: „22.02.2024 3:45:50“
},
{
„sn“: „59C9AB8D“,
„Werte“: [
[
245,3,
6,5,
1604,
46055,7,
0,
null,
null
],
[
245,3,
6,5,
-910,
15726,73,
8956,56,
null,
null
],
[
null,
null,
null,
null,
null,
null,
null
],
[
245,3,
6,5,
-910,
15726,73,
8956,56,
null,
null
]
],
„gmtTime“: „22.02.2024 3:45:15“
},
{
„sn“: „3FE34ABE“,
„Werte“: [
[
230,
15,9,
3650,1,
2704,35,
0,
49,99,
0,94
],
[
230,
-11,5,
-2650,1,
1411,31,
1722,35,
49,99,
0,94
],
[
230,
4,3,
1000,
1946,03,
0,
49,99,
0,94
]
],
„gmtTime“: 22.02.2024 3:46:01"
}
],
"erfolgreich":true,
"Nachricht":null
}
Abrufen der stündlichen/täglichen kWh-Werte für die Wechselrichtererzeugung und den Netzaustausch (sowohl exportiert als auch importiert)
URL:https://www.iammeter.com/api/v1/site/energyhistory/?Startzeit={2024-05-05}&Endzeit={2024-07-07}&gruppiere nach=&Zeichen={2be6d1xxxxxxcc688}
Methode: erhalten
Grenze：
groupby = Tag: 90-Tage-Daten (90 Stück Daten)
groupby = Stunde: 7-Tage-Daten (168 Stück Daten)
| Name | Typ | Des | Beispiel | |
|---|---|---|---|---|
| Zeichen | Zeichenfolge | Token des Kontos | xxx | erforderlich |
| Orts-ID | Nummer | ID des Ortes | erforderlich | |
| Startzeit | Schnur | Startzeit dieser API-Rückgabe | 2023-09-01 | erforderlich |
| Endzeit | Schnur | Stoppzeit dieser API-Rückgabe | 2023-09-07 | erforderlich |
| Gruppenhy | Aufzählung | Wählen Sie das Rückgabeintervall (Stunde/Tag) | Tag/Stunde | erforderlich |
Orts-ID: Meine Orte->Bearbeiten
Orts-ID: 1360
startTime=2024-05-05
Endzeit = 07.05.2024
gruppieren nach=Tag
{
"Daten": [{
"Zeit": "5.5.2024 0:00:00",
"Ertrag": 0,
"VonGrid": 9,62,
"ZuGrid": 0,
"Sonderlast": 0,
"Selbstnutzung": 0
},
{
"Zeit": "6.5.2024 0:00:00",
"Ertrag": 0,
"VonGrid": 9,16,
"ZuGrid": 0,
"Sonderlast": 0,
"Selbstnutzung": 0
}
],
„erfolgreich“: wahr,
„Nachricht“: null
}Orts-ID:2393
startTime=2024-05-05
Endzeit = 07.05.2024
gruppieren nach=Tag
{
"Daten": [{
"Zeit": "5.5.2024 0:00:00",
"Ertrag": 0,
"VonGrid": 0,
"ZuGrid": 0,
"Sonderlast": 0,
"Selbstnutzung": 0
},
{
"Zeit": "6.5.2024 0:00:00",
"Ertrag": 0,1,
"VonGrid": 0,22,
"ZuGrid": 7,15,
"Sonderlast": 0,
"Selbstnutzung": 0
}
],
„erfolgreich“: wahr,
„Nachricht“: null
}Orts-ID:2393
startTime=2024-05-05
Endzeit = 06.05.2024
groupby=Stunde
{
"Daten": [{
"Zeit": "5.5.2024 0:00:00",
"Ertrag": 0,
"VonGrid": 0,
"ZuGrid": 0,
"Sonderlast": 0,
"Selbstnutzung": 0
},
{
"Zeit": "5.5.2024 1:00:00",
"Ertrag": 0,
"VonGrid": 0,
"ZuGrid": 0,
"Sonderlast": 0,
"Selbstnutzung": 0
},
{
"Zeit": „5.5.2024 2:00:00“,
„Ertrag“: 0,
„von Grid“: 0,
„zum Grid“: 0,
„Speziallast“: 0,
„Selbstnutzung“: 0
},
{
„Zeit“: „5.5.2024 3:00:00“,
„Ertrag“: 0,
„von Grid“: 0,
„zum Grid“: 0,
„Speziallast“: 0,
„Selbstnutzung“: 0
},
{
„Zeit“: „5.5.2024 4:00:00“,
„Ertrag“: 0,
„von Grid“: 0,
„zum Grid“: 0,
„Speziallast“: 0,
„Selbstnutzung“: 0
},
{
„Zeit“: „5.5.2024 5:00:00“,
„Ertrag“: 0,
„von Grid“: 0,
„zum Grid“: 0,
„Speziallast“: 0,
„Selbstnutzung“: 0
},
{
„Zeit“: „5.5.2024 6:00:00“,
„Ertrag“: 0,
„von Grid“: 0,
„toGrid“: 0,
„specialLoad“: 0,
„selfUse“: 0
},
{
„time“: „2024/5/5 7:00:00“,
„yield“: 0,
„fromGrid“: 0,
„toGrid“: 0,
„specialLoad“: 0,
„selfUse“: 0
},
{
„time“: „2024/5/5 8:00:00“,
„yield“: 0,
„fromGrid“: 0,
„toGrid“: 0,
„specialLoad“: 0,
„selfUse“: 0
},
{
„Zeit“: „5.5.2024 9:00:00“,
„Ertrag“: 0,
„fromGrid“: 0,
„toGrid“: 0,
„specialLoad“: 0,
„selfUse“: 0
},
{
„Zeit“: „5.5.2024 10:00:00“,
„Ertrag“: 0,
„fromGrid“: 0,
„toGrid“: 0,
„specialLoad“: 0,
„selfUse“: 0
},
{
„Zeit“: „5.5.2024 11:00:00“,
„Ertrag“: 0,
„von Grid“: 0,
„zum Grid“: 0,
„Speziallast“: 0,
„Selbstnutzung“: 0
},
{
„Zeit“: „5.5.2024 12:00:00“,
„Ertrag“: 0,
„von Grid“: 0,
„zum Grid“: 0,
„Speziallast“: 0,
„Selbstnutzung“: 0
},
{
„Zeit“: „5.5.2024 13:00:00“,
„Ertrag“: 0,
„von Grid“: 0,
„zum Grid“: 0,
„Speziallast“: 0,
„Selbstnutzung“: 0
},
{
„Zeit“: „5.5.2024 14:00:00“,
„Ertrag“: 0,
„von Grid“: 0,
„zum Grid“: 0,
„Speziallast“: 0,
„Selbstnutzung“: 0
},
{
„Zeit“: „5.5.2024 15:00:00“,
„Ertrag“: 0,
„von Grid“: 0,
„toGrid“: 0,
„specialLoad“: 0,
„selfUse“: 0
},
{
„time“: „2024/5/5 16:00:00“,
„yield“: 0,
„fromGrid“: 0,
„toGrid“: 0,
„specialLoad“: 0,
„selfUse“: 0
},
{
„time“: „2024/5/5 17:00:00“,
„yield“: 0,
„fromGrid“: 0,
„toGrid“: 0,
„specialLoad“: 0,
„selfUse“: 0
},
{
„Zeit“: „5.5.2024 18:00:00“,
„Ertrag“: 0,
„fromGrid“: 0,
„toGrid“: 0,
„specialLoad“: 0,
„selfUse“: 0
},
{
„Zeit“: „5.5.2024 19:00:00“,
„Ertrag“: 0,
„fromGrid“: 0,
„toGrid“: 0,
„specialLoad“: 0,
„selfUse“: 0
},
{
„Zeit“: „5.5.2024 20:00:00“,
„Ertrag“: 0,
„von Grid“: 0,
„zum Grid“: 0,
„Speziallast“: 0,
„Selbstnutzung“: 0
},
{
„Zeit“: „5.5.2024 21:00:00“,
„Ertrag“: 0,
„von Grid“: 0,
„zum Grid“: 0,
„Speziallast“: 0,
„Selbstnutzung“: 0
},
{
„Zeit“: „5.5.2024 22:00:00“,
„yield“: 0,
„fromGrid“: 0,
„toGrid“: 0,
„specialLoad“: 0,
„selfUse“: 0
},
{
„time“: „2024/5/5 23:00:00“,
„yield“: 0,
„fromGrid“: 0,
„toGrid“: 0,
„specialLoad“: 0,
„selfUse“: 0
}
],
„successful“: true,
„message“: null
}Welche Möglichkeiten bietet IAMMETER?
Welcher Stromzählertyp passt am besten zu Ihren Anforderungen?
So finden Sie den Powermeter im Hinblick auf Ihre Anforderungen
Verwenden Sie den 3-Phasen-Energiezähler so, wie Sie es bevorzugen
Dreiphasiger WLAN-Energiezähler (WEM3080T)
Einphasiger WLAN-Energiezähler (WEM3080)
Dreiphasiger WLAN-Energiezähler (WEM3046T)
Dreiphasiger WLAN-Energiezähler (WEM3050T)