IAMMETER-cloud tilbyr noen API-er, og utviklere kan bruke disse API-ene til å gjøre interessant arbeid, for eksempel å integrere IAMMETER-data i et tredjepartssystem. Tidligere åpnet vi disse API-ene kun for våre forretningspartnere og noen store kunder, men vi har nå bestemt oss for å åpne dem for alle våre kunder.
Velkommen til å dele dine tanker på forumet vårt. https://imeter.club
API-et kan ikke besøkes uten begrensninger; vi vil begrense det daglige antallet kall for hvert API. Vennligst ikke kall API-et for ofte.
Hvis antallet kall overskrider time- eller dagsbegrensningen, vil API-et ikke returnere noe.
| Nr. | API | begrensningstype | per time | per dag | beskrivelse |
|---|---|---|---|---|---|
| 1 | /user/login | ip | 5 | 30 | én IP har kun lov til å kalle dette API-et 5 ganger per time |
| 2 | /site/meterdata/ | SN | 12 | ett SN har kun lov til å kalle dette API-et 12 ganger per time | |
| 3 | /site/powerAnalysis | SN | 5 | ett SN har kun lov til å kalle dette API-et 5 ganger per dag | |
| 4 | /site/offlineAnalysis | SN | 5 | ett SN har kun lov til å kalle dette API-et 5 ganger per dag |
Returnerer token for kontoen. Token-en vil bli brukt i nesten alle API-ene.
Du trenger ikke å kalle dette API-et med mindre du vil oppdatere token-en. Vennligst ikke kall dette API-et mer enn 5 ganger i løpet av én time, og ikke mer enn 30 ganger i løpet av én dag.
Hent token for kontoen som brukes i alle API-ene.
URL: https://www.iammeter.com/api/v1/user/login
Metode: post
Dette API-et kan testes online i IAMMETER SwaggerUI get token
| Nr. | parameter | merknad | eksempel |
|---|---|---|---|
| 1 | brukernavn | Brukernavn for IAMMETER | test |
| 2 | passord | passord for IAMMETER | 123456 |
Token-verdien vil bli brukt i alle API-ene nedenfor.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
Denne token-en kan også leses direkte etter at du har logget inn i systemet.
Hent siste opplastede data for det aktuelle SN.
Vennligst ikke kall dette API-et mer enn 12 ganger i løpet av én time.
Grunnleggende (meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Dette API-et kan testes online i IAMMETER SwaggerUI
Avansert (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Dette API-et kan testes online i IAMMETER SwaggerUI meterdata og IAMMETER SwaggerUI meterdata2
Metode: GET
Begrensning: vennligst ikke forespør dette API-et mer enn 288 ganger hver dag (5 minutters intervall).
Forskjellen mellom grunnleggende og avansert:
Grunnleggende: uten PF (effektfaktor)
Avansert: med PF (effektfaktor)
| Navn | Type | Eksempel | |
|---|---|---|---|
| Token | String | xxx | påkrevd |
| rtctime | string | 2025-6-16 | valgfri |
Verdidefinisjon: spenning, strøm, aktiv effekt, importert kWh, eksportert kWh
{
"data": {
"values": [
[
230.220, //spenning
1.300, //strøm
119.000,//aktiv effekt
1766.590, //importert kWh
0.000 //eksportert kWh
]
],
"localTime": "2020/8/28 15:27:33",
"gmtTime": "2020/8/28 5:27:33"
},
"successful": true,
"message": null
}
Verdidefinisjon: spenning, strøm, aktiv effekt, effektfaktor, importert kWh, eksportert kWh.
Selv om vi er klar over at det ikke er optimalt å plassere effektfaktoren mellom aktiv effekt og importert energi, er det nåværende formatet allerede satt opp på denne måten – vær oppmerksom på denne ordningen.
{
"data":{
"values":[
[
233.41, //spenning
0.718,//strøm
111,//aktiv effekt
0.66,//effektfaktor
5724.85, //importert energi
0 //eksportert energi
]
],
"localTime":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"successful":true,
"message":null
}
De tre array-ene i values representerer fase A, fase B og fase C.
Verdidefinisjon: spenning, strøm, aktiv effekt, importert kWh, eksportert kWh
{
"data": {
"values": [
[
242.600,//spenning
1.000,//strøm
216.000,//aktiv effekt
32354.600,//importert energi
0.000//eksportert energi
],
[
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
}
Elementdefinisjon: spenning, strøm, aktiv effekt, effektfaktor, importert kWh, eksportert kWh
{
"data":{
"values":[
[//fase A
233.8,//spenning
0.03,//strøm
4,//aktiv effekt
0.57,//effektfaktor
222.53,//importert kWh
0 //eksportert kWh
],
[//fase B
5,
0,
0,
0,
0,
0
],
[ //fase 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) er også en parameter i HTTP GET-forespørselen, som vist nedenfor:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
Denne forespørselen vil returnere den opplastede målerdataverdien nærmest den angitte datoen (2025-6-16), det vil si nærmeste registrerte tidspunkt.
Merk: disse API-ene er de samme som i forrige kapittel, bare med noen flere parametere.
Returnerer historiske data for det angitte intervallet og tidsrommet.
Øyeblikksdataene har 1 minutts intervall. Det er 60*24=1440 datastykker per dag. Hvis du forespør historiske data i 1 minutts intervall, kan du kun forespørre data fra 1,39 (2000/1440) dager. Men hvis du forespør data i 5 minutters intervall, kan du forespørre data fra nesten 7 dager.
Grunnleggende (meterdatalist): https://www.iammeter.com/api/v1/site/meterdatalist/{sn}
Avansert (meterdatalist2): https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Forskjellen mellom grunnleggende og avansert:
Grunnleggende: uten PF (effektfaktor)
Avansert: med PF (effektfaktor)
Dette API-et kan testes online i IAMMETER SwaggerUI meterdata og IAMMETER SwaggerUI meterdata2
| Navn | Type | Eksempel | |
|---|---|---|---|
| Token | String | xxx | påkrevd |
| interval | number | 300 | påkrevd, enhet: sekund |
| startTime | string | 2023-09-01 | påkrevd |
| endTime | string | 2023-09-07 | påkrevd |
Data: [spenning, strøm, effekt, importert energi, eksportert energi, UTC-tid, lokal tid]
{
"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,//faseA spenning
0,//strøm
0,//aktiv effekt
468.41,//importert kWh
0,//eksportert kWh
230,//FaseB
0,
0,
236.58,
290.77,
230,//Fase 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":[
{ //første data
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"values":[
[ //fase A
235.2,//spenning
0.03,//strøm
4,//aktiv effekt
0.57,//effektfaktor
210.21,//import kWh
0 //eksportert kWh
],
[//fase B
5.5,
0,
0,
0,
0,
0
],
[ //fase C
3.3,
0,
0,
0,
0,
0
]
]
},
{ //andre 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
]
]
},
{ //tredje 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 effektanalyseresultatet for det angitte tidspunktet.
Vennligst ikke kall dette API-et mer enn 5 ganger i løpet av én dag.
URL: https://www.iammeter.com/api/v1/site/powerAnalysis
Metode: get
Begrensning: vennligst ikke forespør dette API-et mer enn 5 ganger per SN hver dag.
| Navn | Type | Eksempel | |
|---|---|---|---|
sn |
String | xxx | påkrevd |
startTime |
String | 2023-09-01 | valgfri |
endTime |
String | 2023-09-07 | valgfri |
Merk:
average: gjennomsnittlig effektavlesning i løpet av dette tidsrommet.
averageDaytime: gjennomsnittlig effektavlesning på dagtid (8:00–20:00) i løpet av dette tidsrommet.
minimum: minimum effektavlesning i løpet av dette tidsrommet.
maximum: maksimum effektavlesning i løpet av dette tidsrommet.
{
"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
}
Returner effektanalyseresultatet for de siste 7 dagene.
Returner effektanalyseresultatet for den angitte dagen
Returnerer frakoblingsstatusen for det aktuelle SN i løpet av det angitte tidsrommet.
Vennligst ikke kall dette API-et mer enn 5 ganger i løpet av én dag.
URL: https://www.iammeter.com/api/v1/site/offlineAnalysis
Metode: Get
Begrensning: vennligst ikke forespør dette API-et mer enn 5 ganger per SN hver dag.
| Navn | Type | Eksempel | |
|---|---|---|---|
sn |
String | xxxx | påkrevd |
startTime |
String | 2023-09-01 | valgfri |
endTime |
String | 2023-09-07 | valgfri |
interval (enhet: minutt) |
Number | 5 | valgfri |
Merk:
Det er totalt 10080 minutter i dette tidsrommet.
Den totale frakoblingstiden er 906 minutter i dette tidsrommet.
Frakoblingsgapet som er større enn 5 minutter, er listet i array-en.
{
"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
}
Returner frakoblingsanalyseresultatet for den angitte dagen
Returnerer den nyeste verdien for alle energimålere i denne kontoen.
URL: https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Metode: Get
Begrensning: sørg for at du ikke sender forespørsler til dette API-et oftere enn én gang hvert 5. minutt.
| Navn | Type | Eksempel | |
|---|---|---|---|
| Token | String | xxx | påkrevd |
{
"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-/dagsbaserte kWh-verdier for vekselretterens produksjon og nettutveksling (både eksportert og importert).
Metode: get
Begrensning:
groupby = day: 90 dagers data (90 stykker data)
groupby = hour: 7 dagers data (168 stykker data)
| Navn | Type | Beskrivelse | Eksempel | |
|---|---|---|---|---|
| Token | String | token for kontoen | xxx | påkrevd |
| place_ID | number | ID for stedet | påkrevd | |
| startTime | string | starttid for dette API-ets retur | 2023-09-01 | påkrevd |
| endTime | string | slutttid for dette API-ets retur | 2023-09-07 | påkrevd |
| groupby | enum | velg returdata-intervall (time/dag) | day/hour | påkrevd |
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 muligheter tilbyr IAMMETER?
Hvilken type strømmåler passer best for dine behov?
Hvordan finne strømmåleren ut fra dine krav
Trefase Wi-Fi energimåler (WEM3080T)
Enfase Wi-Fi energimåler (WEM3080)
Trefase Wi-Fi energimåler (WEM3046T)
Trefase Wi-Fi energimåler (WEM3050T)