IAMMETER-Cloud stellt einige APIs bereit, und Entwickler können diese APIs nutzen, um interessante Arbeiten durchzuführen, wie z. B. die Integration der IAMMETER-Daten in ein Drittanbietersystem. Bisher haben wir diese APIs nur unseren Geschäftspartnern und einigen Großkunden zur Verfügung gestellt, aber wir haben uns entschlossen, sie jetzt allen unseren Kunden zu öffnen.
Teilen Sie uns gerne Ihre Meinung in unserem Forum mit. https://imeter.club
Die API kann nicht unbegrenzt aufgerufen werden. Wir begrenzen die tägliche Anzahl der Aufrufe für jede API. Bitte rufen Sie die API nicht zu häufig auf.
Wenn die Anzahl der Aufrufe die stündliche oder tägliche Begrenzung überschreitet, gibt die API nichts zurück.
| Nr. | API | Begrenzungstyp | Stündlich | Täglich | Beschreibung |
|---|---|---|---|---|---|
| 1 | /user/login | IP | 5 | 30 | Pro IP ist dieser API nur 5-mal pro Stunde erlaubt |
| 2 | /site/meterdata/ | SN | 12 | Pro SN ist dieser API nur 12-mal pro Stunde erlaubt | |
| 3 | /site/powerAnalysis | SN | 5 | Pro SN ist dieser API nur 5-mal pro Tag erlaubt | |
| 4 | /site/offlineAnalysis | SN | 5 | Pro SN ist dieser API nur 5-mal pro Tag erlaubt |
Gibt 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 den Token aktualisieren. Bitte rufen Sie diese API nicht mehr als 5-mal pro Stunde und nicht mehr als 30-mal pro Tag auf.
Ruft den Token des Kontos ab, der in allen APIs verwendet wird.
URL: https://www.iammeter.com/api/v1/user/login
Methode: POST
Diese API kann online getestet werden in IAMMETER SwaggerUI Token abrufen
| Nr. | Parameter | Beschreibung | Beispiel |
|---|---|---|---|
| 1 | Benutzername | Benutzername von IAMMETER | test |
| 2 | Passwort | Passwort von IAMMETER | 123456 |
Der Token-Wert wird in allen nachfolgenden APIs verwendet.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
Dieser Token kann auch direkt nach dem Einloggen in das System ausgelesen werden.

Ruft die letzten hochgeladenen Daten mit der zugehörigen SN ab.
Bitte rufen Sie diese API nicht mehr als 12-mal pro Stunde auf.
Basis (meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Diese API kann online getestet werden in IAMMETER SwaggerUI
Erweitert (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Diese API kann online getestet werden in IAMMETER SwaggerUI meterdata und IAMMETER SwaggerUI meterdata2
Methode: GET
Begrenzung: Bitte fordern Sie diese API nicht mehr als 288-mal pro Tag an (5-Minuten-Intervall).
Der Unterschied zwischen Basis und Erweitert:
Basis: Ohne PF (Leistungsfaktor)
Erweitert: Mit PF (Leistungsfaktor)
| Name | Typ | Beispiel | |
|---|---|---|---|
| Token | String | xxx | erforderlich |
| rtctime | string | 2025-6-16 | optional |
Werte-Definition: voltage, current, active power, imported kWh, exported kWh
{
"data": {
"values": [
[
230.220, //voltage
1.300, //current
119.000,//active power
1766.590, //imported kWh
0.000 //exported kWh
]
],
"localTime": "2020/8/28 15:27:33",
"gmtTime": "2020/8/28 5:27:33"
},
"successful": true,
"message": null
}
Werte-Definition: voltage, current, active power, power factor, imported kWh, exported kWh.
Wir weisen darauf hin, dass die Platzierung des Leistungsfaktors zwischen Wirkleistung und importierter Energie nicht optimal ist, aber das aktuelle Format ist bereits so eingerichtet – bitte beachten Sie diese Anordnung.
{
"data":{
"values":[
[
233.41, //voltage
0.718,//current
111,//active power
0.66,//power factor
5724.85, //imported energy
0 //exported energy
]
],
"localTime":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"successful":true,
"message":null
}
Die drei Arrays in values repräsentieren Phase A, Phase B und Phase C.
Werte-Definition: voltage, current, active power, imported kWh, exported kWh
{
"data": {
"values": [
[
242.600,//voltage
1.000,//current
216.000,//active power
32354.600,//imported energy
0.000//exported energy
],
[
242.600,
1.000,
1986.000,
30536.410,
17704.720
],
[
0.000,
0.000,
0.000,
0.000,
0.000
]
],
"localTime": "2020/8/28 15:30:48",
"gmtTime": "2020/8/28 5:30:48"
},
"successful": true,
"message": null
}
Element-Definition: voltage, current, active power, power factor, imported kWh, exported kWh
{
"data":{
"values":[
[//phase A
233.8,//voltage
0.03,//current
4,//active power
0.57,//power factor
222.53,//imported kWh
0 //exported kWh
],
[//phase B
5,
0,
0,
0,
0,
0
],
[ //phase C
3.1,
0,
0,
0,
0,
0
]
],
"localTime":"2023/11/21 14:39:36",
"gmtTime":"2023/11/21 6:39:36"
},
"successful":true,
"message":null
}

Die RTC (Echtzeituhr) ist ebenfalls ein Parameter in der HTTP-GET-Anfrage, wie unten gezeigt:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
Diese Anfrage gibt den hochgeladenen Zählerdatenwert zurück, der dem angegebenen Datum (2025-6-16) am nächsten liegt, also den nächstgelegenen aufgezeichneten Zeitpunkt.
Hinweis: Diese APIs sind identisch mit denen im vorherigen Kapitel, es wurden nur einige zusätzliche Parameter hinzugefügt.
Gibt die historischen Daten im eingestellten Intervall und Zeitbereich zurück.
Die aktuellen Daten haben ein 1-Minuten-Intervall. Es gibt 60*24=1440 Datenpunkte pro Tag. Wenn Sie die historischen Daten im 1-Minuten-Intervall anfordern, können Sie nur die Daten von 1,39 (2000/1440) Tagen abrufen. Wenn Sie die Daten im 5-Minuten-Intervall anfordern, können Sie die Daten von fast 7 Tagen abrufen.
Basis (meterdatalist): https://www.iammeter.com/api/v1/site/meterdatalist/{sn}
Erweitert (meterdatalist2): https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Der Unterschied zwischen Basis und Erweitert:
Basis: Ohne PF (Leistungsfaktor)
Erweitert: Mit PF (Leistungsfaktor)
Diese API kann online getestet werden in IAMMETER SwaggerUI meterdata und IAMMETER SwaggerUI meterdata2
| Name | Typ | Beispiel | |
|---|---|---|---|
| Token | String | xxx | erforderlich |
| interval | number | 300 | erforderlich, Einheit: Sekunde |
| startTime | string | 2023-09-01 | erforderlich |
| endTime | string | 2023-09-07 | erforderlich |
Daten: [voltage, current, power, import energy, export energy, utc time, local time]
{
"data": [
[
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"
]
],
"successful": true,
"message": null
}
{
"data": [
[
230,//phaseA voltage
0,//current
0,//active power
468.41,//imported kWh
0,//exported 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"
]
],
"successful": true,
"message": null
}
{
"data":[
{ //erster Datenpunkt
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"values":[
[ //phase A
235.2,//voltage
0.03,//current
4,//active power
0.57,//power factor
210.21,//import kWh
0 //exported kWh
],
[//phase B
5.5,
0,
0,
0,
0,
0
],
[ //phase C
3.3,
0,
0,
0,
0,
0
]
]
},
{ //zweiter Datenpunkt
"rtcTime":"2023/9/1 8:00:49",
"gmtTime":"2023/9/1 0:00:49",
"values":[
[
233.4,
0.03,
4,
0.57,
210.24,
0
],
[
5.4,
0,
0,
0,
0,
0
],
[
3.3,
0,
0,
0,
0,
0
]
]
},
{ //dritter Datenpunkt
"rtcTime":"2023/9/1 16:00:24",
"gmtTime":"2023/9/1 8:00:24",
"values":[
[
235.6,
0.03,
4,
0.57,
210.27,
0
],
[
5.5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
"successful":true,
"message":null
}

Gibt das Ergebnis der Leistungsanalyse im angegebenen Zeitraum zurück.
Bitte rufen Sie diese API nicht mehr als 5-mal pro Tag auf.
URL: https://www.iammeter.com/api/v1/site/powerAnalysis
Methode: GET
Begrenzung: Bitte fordern Sie diese API pro SN nicht mehr als 5-mal pro Tag an.
| Name | Typ | Beispiel | |
|---|---|---|---|
sn |
String | xxx | erforderlich |
startTime |
String | 2023-09-01 | optional |
endTime |
String | 2023-09-07 | optional |
Hinweis:
average: Durchschnittliche Leistungsaufnahme in diesem Zeitraum.
averageDaytime: Durchschnittliche Leistungsaufnahme tagsüber (8:00-20:00 Uhr) in diesem Zeitraum.
minimum: Minimale Leistungsaufnahme in diesem Zeitraum.
maximum: Maximale Leistungsaufnahme in diesem Zeitraum.
{
"data": {
"startTime": "2023-09-01",
"endTime": "2023-09-07",
"average": 862.6,
"averageDaytime": 836.9,
"minimum": 259.0,
"maximum": 3999.0
},
"successful": true,
"message": null
}
Das Ergebnis der Leistungsanalyse der letzten 7 Tage zurückgeben.

Das Ergebnis der Leistungsanalyse des angegebenen Tages zurückgeben.

Gibt den Verbindungsstatus der angegebenen SN im angegebenen Zeitraum zurück.
Bitte rufen Sie diese API nicht mehr als 5-mal pro Tag auf.
URL: https://www.iammeter.com/api/v1/site/offlineAnalysis
Methode: GET
Begrenzung: Bitte fordern Sie diese API pro SN nicht mehr als 5-mal pro Tag an.
| Name | Typ | Beispiel | |
|---|---|---|---|
sn |
String | xxxx | erforderlich |
startTime |
String | 2023-09-01 | optional |
endTime |
String | 2023-09-07 | optional |
interval(unit :minute) |
Number | 5 | optional |
Hinweis:
Es gibt insgesamt 10080 Minuten in diesem Zeitbereich.
Die gesamte Offline-Zeit beträgt 906 Minuten in diesem Zeitbereich.
Die Offline-Lücke, die größer als 5 Minuten ist, wird im Array aufgelistet.
{
"data": {
"startTime": "2023-09-05",
"endTime": "2023-09-11",
"offlineCount": 906,
"totalCount": 10080,
"list": [
{
"startTime": "2023/9/5 0:00:00",
"endTime": "2023/9/5 15:06:14",
"duration": 906
}
]
},
"successful": true,
"message": null
}
Das Ergebnis der Offline-Analyse des angegebenen Tages zurückgeben.

Gibt die neuesten Werte aller Energiezähler in diesem Konto zurück.
URL: https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Methode: GET
Begrenzung: Bitte stellen Sie sicher, dass Sie diese API nicht häufiger als einmal alle 5 Minuten aufrufen.
| Name | Typ | Beispiel | |
|---|---|---|---|
| Token | String | xxx | erforderlich |
{
"data":[
{
"sn":"DA2BED94",
"values":[
223.71,
1.74,
225,
14761.03,
0
],
"gmtTime":"2024/2/22 3:46:20"
},
{
"sn":"B384789C",
"values":[
[
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":"2024/2/22 3:45:15"
},
{
"sn":"674B1E5D",
"values":[
[
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":"2024/2/22 3:45:50"
},
{
"sn":"59C9AB8D",
"values":[
[
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":"2024/2/22 3:45:15"
},
{
"sn":"3FE34ABE",
"values":[
[
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":"2024/2/22 3:46:01"
}
],
"successful":true,
"message":null
}

Ruft die stündlichen/täglichen kWh-Werte für die Wechselrichtererzeugung und den Netzbezug (sowohl exportiert als auch importiert) ab.
Methode: GET
Begrenzung:
groupby = day :90 Tage Daten (90 Datenpunkte)
groupby = hour :7 Tage Daten (168 Datenpunkte)
| Name | Typ | Beschreibung | Beispiel | |
|---|---|---|---|---|
| Token | String | Token des Kontos | xxx | erforderlich |
| place_ID | number | ID des Ortes | erforderlich | |
| startTime | string | Startzeit der API-Rückgabe | 2023-09-01 | erforderlich |
| endTime | string | Endzeit der API-Rückgabe | 2023-09-07 | erforderlich |
| groupby | enum | Datenintervall auswählen (Stunde/Tag) | day/hour | erforderlich |
Place_ID: Meine Orte -> Bearbeiten

place_id:1360
startTime=2024-05-05
endTime=2024-05-07
groupby=day
{
"data": [{
"time": "2024/5/5 0:00:00",
"yield": 0,
"fromGrid": 9.62,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/6 0:00:00",
"yield": 0,
"fromGrid": 9.16,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
}
],
"successful": true,
"message": null
}
place_id:2393
startTime=2024-05-05
endTime=2024-05-07
groupby=day
{
"data": [{
"time": "2024/5/5 0:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/6 0:00:00",
"yield": 0.1,
"fromGrid": 0.22,
"toGrid": 7.15,
"specialLoad": 0,
"selfUse": 0
}
],
"successful": true,
"message": null
}
place_id:2393
startTime=2024-05-05
endTime=2024-05-06
groupby=hour
{
"data": [{
"time": "2024/5/5 0:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 1:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 2:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 3:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 4:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 5:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 6:00:00",
"yield": 0,
"fromGrid": 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
},
{
"time": "2024/5/5 9:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 10:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 11:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 12:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 13:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 14:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 15:00:00",
"yield": 0,
"fromGrid": 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
},
{
"time": "2024/5/5 18:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 19:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 20:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 21:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 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 Funktionen bietet IAMMETER?
Welcher Stromzähler-Typ passt am besten zu Ihren Anforderungen?
Wie finden Sie den passenden Stromzähler für Ihre Anforderungen
Nutzen Sie den Dreiphasen-Energiezähler so, wie Sie es bevorzugen
Dreiphasiger Wi-Fi-Energiezähler (WEM3080T)
Einphasiger Wi-Fi-Energiezähler (WEM3080)
Dreiphasiger Wi-Fi-Energiezähler (WEM3046T)
Dreiphasiger Wi-Fi-Energiezähler (WEM3050T)