IAMMETER-cloud leverer nogle API'er, og udviklere kan bruge disse API'er til at lave interessante ting, f.eks. integrere IAMMETER-data i et tredjepartssystem. Tidligere gav vi kun disse API'er til vores forretningspartnere og nogle store kunder, men vi har nu besluttet at åbne dem for alle vores kunder.
Du er velkommen til at dele dine tanker med os på vores forum. https://imeter.club
API'et kan ikke tilgås ubegrænset. Vi begrænser det daglige antal kald for hvert API. Kald venligst ikke API'et oftere end nødvendigt.
Hvis antallet af kald overstiger time- eller dagsbegrænsningen, returnerer API'et intet.
| Nr. | API | begrænsningstype | pr. time | dagligt | beskrivelse |
|---|---|---|---|---|---|
| 1 | /user/login | ip | 5 | 30 | Én IP-adresse må kun kalde dette API 5 gange i timen |
| 2 | /site/meterdata/ | SN | 12 | Ét SN må kun kalde dette API 12 gange i timen | |
| 3 | /site/powerAnalysis | SN | 5 | Ét SN må kun kalde dette API 5 gange dagligt | |
| 4 | /site/offlineAnalysis | SN | 5 | Ét SN må kun kalde dette API 5 gange dagligt |
Returnerer kontoens token. Token'et bruges i næsten alle API'erne.
Du behøver ikke kalde dette API, medmindre du vil forny token'et. Kald venligst ikke dette API mere end 5 gange på en time og ikke mere end 30 gange på en dag.
Hent token'et for den konto, der bruges i alle API'erne.
URL: https://www.iammeter.com/api/v1/user/login
Metode: post
Dette API kan testes online i IAMMETER SwaggerUI – hent token
| Nr. | parameter | bemærkning | eksempel |
|---|---|---|---|
| 1 | user name | IAMMETER-brugernavn | test |
| 2 | password | IAMMETER-adgangskode | 123456 |
Token-værdien bruges i alle API'erne nedenfor.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
Dette token kan også aflæses direkte, når du er logget ind på systemet.
Hent de senest uploadede data for den pågældende SN.
Kald venligst ikke dette API mere end 12 gange på en time.
Basic(meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Dette API kan testes online i IAMMETER SwaggerUI
Advanced(meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Dette API kan testes online i IAMMETER SwaggerUI meterdata og IAMMETER SwaggerUI meterdata2
Metode: GET
Begrænsning: Anmod venligst ikke om dette API mere end 288 gange om dagen (5 minutters interval).
Forskellen mellem basic og advanced:
Basic: uden PF (Power factor)
Advanced: med PF (Power factor)
| Navn | Type | Eksempel | |
|---|---|---|---|
| Token | String | xxx | påkrævet |
| rtctime | string | 2025-6-16 | valgfri |
Værdidefinition: 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ærdidefinition: voltage, current, active power, power factor, imported kWh, exported kWh.
Vi er opmærksomme på, at placeringen af power factor mellem active power og importeret energi ikke er optimal, men det nuværende format er allerede opbygget sådan – vær opmærksom på denne placering
{
"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 arrays i values repræsenterer fase A, fase B og fase C.
Værdidefinition: 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'en (Real-Time Clock) er også en parameter i HTTP GET-anmodningen, som vist nedenfor:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
Denne anmodning returnerer den uploadede målerdata-værdi, der ligger tættest på den angivne dato (2025-6-16), dvs. det nærmeste registrerede tidspunkt.
Bemærk: Disse API'er er de samme som i det foregående kapitel, blot med nogle ekstra parametre
Returnerer de historiske data for det angivne interval og tidsrum.
Øjebliksdata ligger i 1-minuts intervaller. Der er 60*24=1440 datapunkter pr. dag. Hvis du anmoder om historiske data i 1-minuts intervaller, kan du kun få data for 1,39 (2000/1440) dage. Men hvis du anmoder om data i 5-minuts intervaller, kan du få data for næsten 7 dage.
Basic(meterdatalist): https://www.iammeter.com/api/v1/site/meterdatalist/{sn}
Advanced(meterdatalist2): https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Forskellen mellem basic og advanced:
Basic: uden PF (Power factor)
Advanced: med PF (Power factor)
Dette API kan testes online i IAMMETER SwaggerUI meterdata og IAMMETER SwaggerUI meterdata2
| Navn | Type | Eksempel | |
|---|---|---|---|
| Token | String | xxx | påkrævet |
| interval | number | 300 | påkrævet, enhed: sekund |
| startTime | string | 2023-09-01 | påkrævet |
| endTime | string | 2023-09-07 | påkrævet |
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
}
Returnerer effektanalyse-resultatet i det angivne tidsrum.
Kald venligst ikke dette API mere end 5 gange på en dag.
URL: https://www.iammeter.com/api/v1/site/powerAnalysis
Metode: get
Begrænsning: Anmod venligst ikke om dette API mere end 5 gange om dagen pr. SN.
| Navn | Type | Eksempel | |
|---|---|---|---|
sn |
String | xxx | påkrævet |
startTime |
String | 2023-09-01 | valgfri |
endTime |
String | 2023-09-07 | valgfri |
Bemærk:
average: gennemsnitlig effektaflæsning i dette tidsrum.
averageDaytime: gennemsnitlig effektaflæsning i dagtimerne (8:00-20:00) i dette tidsrum.
minimum: mindste effektaflæsning i dette tidsrum.
maximum: største effektaflæsning i dette tidsrum.
{
"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
}
Returnér effektanalyse-resultatet for de sidste 7 dage.
Returnér effektanalyse-resultatet for den angivne dag
Returnerer frakoblingsstatus for den pågældende SN i det angivne tidsrum.
Kald venligst ikke dette API mere end 5 gange på en dag.
URL: https://www.iammeter.com/api/v1/site/offlineAnalysis
Metode: Get
Begrænsning: Anmod venligst ikke om dette API mere end 5 gange om dagen pr. SN.
| Navn | Type | Eksempel | |
|---|---|---|---|
sn |
String | xxxx | påkrævet |
startTime |
String | 2023-09-01 | valgfri |
endTime |
String | 2023-09-07 | valgfri |
interval (enhed: minut) |
Number | 5 | valgfri |
Bemærk:
Der er i alt 10080 minutter i dette tidsrum.
Den samlede offline-tid er 906 minutter i dette tidsrum.
Offline-perioder på mere end 5 minutter er angivet i arrayet.
{
"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
}
Returnér offlineanalyse-resultatet for den angivne dag
Returnerer de nyeste værdier fra alle energimålere på denne konto.
URL: https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Metode: Get
Begrænsning: Sørg for ikke at sende anmodninger til dette API oftere end én gang hvert 5. minut.
| Navn | Type | Eksempel | |
|---|---|---|---|
| Token | String | xxx | påkrævet |
{
"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
}
Hent time-/dagsbaserede kWh-værdier for inverterproduktion og netudveksling (både eksporteret og importeret)
Metode: get
Begrænsning:
groupby = day: 90 dages data (90 datapunkter)
groupby = hour: 7 dages data (168 datapunkter)
| Navn | Type | Beskrivelse | Eksempel | |
|---|---|---|---|---|
| Token | String | kontoens token | xxx | påkrævet |
| place_ID | number | ID på placeringen | påkrævet | |
| startTime | string | starttidspunkt for dette API's retur | 2023-09-01 | påkrævet |
| endTime | string | sluttidspunkt for dette API's retur | 2023-09-07 | påkrævet |
| groupby | enum | vælg returinterval for data (hour/day) | day/hour | påkrævet |
Place_ID: Mine steder -> Rediger
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
}
Hvilke funktioner tilbyder IAMMETER?
Hvilken type elmåler passer bedst til dine behov?
Sådan finder du den energimåler, der matcher dine krav
Trefaset Wi-Fi energimåler (WEM3080T)
Enfaset Wi-Fi energimåler (WEM3080)
Trefaset Wi-Fi energimåler (WEM3046T)
Trefaset Wi-Fi energimåler (WEM3050T)