IAMMETER-cloud tillhandahåller vissa API:er, och utvecklaren kan använda dessa API:er för att göra en del intressanta saker, till exempel integrera IAMMETER:s data i något tredjepartssystem. Vi öppnade tidigare bara dessa API:er för våra affärspartners och några stora kunder, men har nu beslutat att öppna dem för alla våra kunder.
Välkommen att dela dina tankar med oss på vårt forum. https://imeter.club
API:et kan inte besökas utan begränsning; vi kommer att begränsa det dagliga anropstalet för varje API. Anropa inte API:et för ofta.
Om anropstalet överstiger tim- eller dygnsbegränsningen kommer API:et inte att returnera något.
| Nr. | API | begränsningstyp | per timme | per dygn | beskrivning |
|---|---|---|---|---|---|
| 1 | /user/login | ip | 5 | 30 | en IP får endast anropa detta api 5 gånger per timme |
| 2 | /site/meterdata/ | SN | 12 | en SN får endast anropa detta api 12 gånger per timme | |
| 3 | /site/powerAnalysis | SN | 5 | en SN får endast anropa detta api 5 gånger per dygn | |
| 4 | /site/offlineAnalysis | SN | 5 | en SN får endast anropa detta api 5 gånger per dygn |
Returnerar kontots token. Tokenen kommer att användas i nästan alla API:er.
Du behöver inte anropa detta API om du inte vill uppdatera tokenen. Anropa inte detta API mer än 5 gånger under en timme, och inte mer än 30 gånger under ett dygn.
Hämta tokenen för kontot som används i alla API:er.
URL: https://www.iammeter.com/api/v1/user/login
Metod: post
Detta api kan testas online i IAMMETER SwaggerUI get token
| Nr. | parameter | anmärkning | exempel |
|---|---|---|---|
| 1 | user name | Användarnamn för IAMMETER | test |
| 2 | password | lösenord för IAMMETER | 123456 |
Tokenvärdet kommer att användas i alla API:er nedan.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
Denna token kan också läsas direkt efter att du har loggat in i systemet.

Hämtar den senast uppladdade datan med den aktuella SN.
Anropa inte detta API mer än 12 gånger under en timme.
Grundläggande (meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Detta api kan testas online i IAMMETER SwaggerUI
Avancerad (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Detta api kan testas online i IAMMETER SwaggerUI meterdata och IAMMETER SwaggerUI meterdata2
Metod: GET
Begränsning: begär inte detta API mer än 288 gånger per dygn (5 minuters intervall).
Skillnaden mellan grundläggande och avancerad:
Grundläggande: utan PF (effektfaktor)
Avancerad: med PF (effektfaktor)
| Namn | Typ | Exempel | |
|---|---|---|---|
| Token | String | xxx | obligatorisk |
| rtctime | string | 2025-6-16 | valfri |
värdedefinition: voltage,current ,active power ,imported kWh, exported kWh
{
"data": {
"values": [
[
230.220, //voltage
1.300, //curent
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
}
värdedefinition: voltage,current ,active power ,power factor,imported kWh, exported kWh.
Även om vi inser att det inte är optimalt att placera effektfaktorn mellan aktiv effekt och importerad energi, är det nuvarande formatet redan uppbyggt på detta sätt — observera denna utformning
{
"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
}
De tre arrayerna i values representerar fas A, fas B och fas C.
värdedefinition: 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
}
Elementdefinition: 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
}

RTC (Real-Time Clock) är också en parameter i HTTP GET-förfrågan, enligt nedan:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
Denna förfrågan returnerar det uppladdade mätardatavärdet som ligger närmast det angivna datumet (2025-6-16), det vill säga den närmaste registrerade tidpunkten.
Obs: dessa API:er är desamma som i föregående kapitel, endast med några fler parametrar
Returnerar historiska data på det angivna intervallet och inom den angivna tidsperioden.
Realtidsdatan har 1 minuts intervall. Det finns 60*24=1440 poster per dygn. Om du begär historiska data med 1 minuts intervall kan du endast begära data för 1,39 (2000/1440) dygn. Men om du begär data med 5 minuters intervall kan du begära data för nästan 7 dygn.
Grundläggande (meterdatalist): https://www.iammeter.com/api/v1/site/meterdatalist/{sn}
Avancerad (meterdatalist2): https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Skillnaden mellan grundläggande och avancerad:
Grundläggande: utan PF (effektfaktor)
Avancerad: med PF (effektfaktor)
Detta api kan testas online i IAMMETER SwaggerUI meterdata och IAMMETER SwaggerUI meterdata2
| Namn | Typ | Exempel | |
|---|---|---|---|
| Token | String | xxx | obligatorisk |
| interval | number | 300 | obligatorisk, enhet: sekund |
| startTime | string | 2023-09-01 | obligatorisk |
| endTime | string | 2023-09-07 | obligatorisk |
Data:[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":[
{ //first data
"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
]
]
},
{ //second data
"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
]
]
},
{ //third data
"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
}

Returnerar effektanalysresultatet för den angivna tiden.
Anropa inte detta API mer än 5 gånger under ett dygn.
URL: https://www.iammeter.com/api/v1/site/powerAnalysis
Metod: get
Begränsning: begär inte detta API mer än 5 gånger per SN och dygn.
| Namn | Typ | Exempel | |
|---|---|---|---|
sn |
String | xxx | obligatorisk |
startTime |
String | 2023-09-01 | valfri |
endTime |
String | 2023-09-07 | valfri |
Obs:
average: genomsnittlig effektavläsning under denna tidsperiod.
averageDaytime: genomsnittlig effektavläsning under dagtid (08:00–20:00) under denna tidsperiod.
minimum: lägsta effektavläsning under denna tidsperiod.
maximum: högsta effektavläsning under denna tidsperiod.
{
"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
}
Returnera effektanalysresultatet för de senaste 7 dygnen.

Returnera effektanalysresultatet för en angiven dag

Returnerar frånkopplingsstatusen för den aktuella SN under den angivna tiden.
Anropa inte detta API mer än 5 gånger under ett dygn.
URL: https://www.iammeter.com/api/v1/site/offlineAnalysis
Metod: Get
Begränsning: begär inte detta API mer än 5 gånger per SN och dygn.
| Namn | Typ | Exempel | |
|---|---|---|---|
sn |
String | xxxx | obligatorisk |
startTime |
String | 2023-09-01 | valfri |
endTime |
String | 2023-09-07 | valfri |
interval(enhet: minut) |
Number | 5 | valfri |
Obs:
Det finns totalt 10080 minuter i denna tidsperiod.
Den totala frånkopplingstiden är 906 minuter i denna tidsperiod.
De frånkopplingsavbrott som är längre än 5 minuter listas i arrayen.
{
"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
}
Returnera frånkopplingsanalysresultatet för en angiven dag

Returnerar det senaste värdet för alla energimätare i detta konto.
URL: https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Metod: Get
Begränsning: se till att du inte gör förfrågningar till detta API oftare än en gång var 5:e minut.
| Namn | Typ | Exempel | |
|---|---|---|---|
| Token | String | xxx | obligatorisk |
{
"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
}

Hämtar tim-/dygnsvärdena för kWh för växelriktarens produktion och nätutbyte (både exporterad och importerad)
Metod: get
Begränsning:
groupby = day :90 dagars data (90 poster)
groupby = hour :7 dagars data (168 poster)
| Namn | Typ | Beskr | Exempel | |
|---|---|---|---|---|
| Token | String | kontots token | xxx | obligatorisk |
| place_ID | number | ID för platsen | obligatorisk | |
| startTime | string | starttid för detta api:s resultat | 2023-09-01 | obligatorisk |
| endTime | string | sluttid för detta api:s resultat | 2023-09-07 | obligatorisk |
| groupby | enum | välj returdata-intervall (timme/dygn) | day/hour | obligatorisk |
Place_ID: My Places->Edit

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
}
Vilka funktioner erbjuder IAMMETER?
Vilken typ av elmätare passar bäst dina behov?
Hur hittar du kraftmätaren utifrån dina krav
Trefas Wi-Fi-energimätare (WEM3080T)
Enfas Wi-Fi-energimätare (WEM3080)
Trefas Wi-Fi-energimätare (WEM3046T)
Trefas Wi-Fi-energimätare (WEM3050T)