IAMMETER-skyen gir noen APIer, og utvikleren kan bruke disse APIene til å gjøre noe interessant arbeid, for eksempel å integrere dataene til IAMMETER til et tredjepartssystem. Vi åpnet nettopp disse APIene for våre forretningspartnere og noen store kunder før, men bestemte oss for å åpne dem for alle våre kunder nå.
Velkommen til å fortelle oss dine tanker på forumet vårt.https://imeter.club
API kan ikke besøkes ubegrenset, vi vil begrense det daglige antallet anrop for hver API. Ikke ring API-en oftere.
Hvis anropstallene overstiger time- eller dagligbegrensningen, vil API-en ikke returnere noe.
Nei. | API | grensetype | hver time | Daglig | beskrivelse |
---|---|---|---|---|---|
1 | /Brukerinnlogging | ip | 5 | 30 | én IP har kun lov til å ringe dette api 5 ganger i timen |
2 | /site/meterdata/ | SN | 12 | ett SN har kun lov til å ringe dette api 12 ganger i timen | |
3 | /side/powerAnalysis | SN | 5 | en SN får bare lov til å ringe dette api 5 ganger daglig | |
4 | /side/offlineAnalyse | SN | 5 | en SN får bare lov til å ringe dette api 5 ganger daglig |
Returner tokenet til kontoen. Tokenet vil bli brukt i nesten hele API-en.
Du trenger ikke å kalle denne API-en med mindre du vil oppdatere tokenet.Ikke ring denne API-en mer enn 5 ganger i løpet av en time, og ikke mer enn 30 ganger på en dag.
Få tokenet til kontoen som brukes i alle API-ene.
URL:https://www.iammeter.com/api/v1/user/login
Metode:post
Dette API-et kan testes på nett iIAMMETER SwaggerUI få token
Nei. | parameter | bemerke | eksempel |
---|---|---|---|
1 | brukernavn | Brukernavn til IAMMETER | test |
2 | passord | passordet til IAMMETER | 123456 |
Tokenverdien vil bli brukt i alle API-ene nedenfor.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"vellykket": sant,
"melding": null
}
Dette tokenet kan også leses direkte etter at du har logget på systemet.
Få de siste opplastingsdataene med den antatte SN.
Ikke ring denne API-en mer enn 12 ganger i løpet av en time.
Grunnleggende (målerdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Dette API-et kan testes på nett iIAMMETER SwaggerUI
Avansert(meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Dette API-et kan testes på nett iIAMMETER SwaggerUI målerdataogIAMMETER SwaggerUI meterdata2
Metode: FÅ
Grense: Vennligst ikke be om denne APIen 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 | nødvendig |
rtctime | streng | 2025-6-16 | valgfri |
verdidefinisjon: spenning, strøm, aktiv effekt, importerte kWh, eksporterte kWh
{
«data»: {
«verdier»: [
[
230,220, //spenning
1,300, //strøm
119,000, //aktiv effekt
1766,590, //importerte kWh
0,000 //eksporterte kWh
]
],
«lokaltid»: «2020/8/28 15:27:33»,
«gmttid»: «2020/8/28 5:27:33»,
},
«vellykket»: sann,
«melding»: null
}
verdidefinisjon: spenning, strøm, aktiv effekt,maktfaktor,importerte kWh, eksporterte kWh.
Selv om vi erkjenner 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»:{
«verdier»:[
[
233,41, //spenning
0,718, //strøm
111, //aktiv effekt
0,66, //effektfaktor
5724,85, //importert energi
0 //eksportert energi
]
],
«lokaltid»: «2023/11/21 14:30:22»,
«gmttid»: «2023/11/21 6:30:22»
},
«vellykket»: sann,
«melding»: null
}
De tre matrisene iverdierrepresenterer fase A, fase B og fase C.
verdidefinisjon: spenning, strøm, aktiv effekt, importerte kWh, eksporterte kWh
{
«data»: {
«verdier»: [
[
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
]
],
«lokaltid»: «2020/8/28 15:30:48»,
«gmtTime»: «2020/8/28 5:30:48»
},
«vellykket»: sann,
«melding»: null
}
Elementdefinisjon: spenning, strøm, aktiv effekt,maktfaktorimporterte kWh, eksporterte kWh
{ «data»:{
«verdier»:[
[//fase A 233,8,//spenning 0,03,//strøm 4,//aktiv effekt 0,57,//effektfaktor 222,53,//importerte kWh 0 //eksporterte kWh
],
[//fase B 5, 0, 0, 0, 0, 0
],
[ //fase C 3,1, 0, 0, 0, 0, 0
]
],
«lokaltid»:»2023/11/21 14:39:36»,
«gmtTime»:»2023/11/21 6:39:36» },
«vellykket»:sann,
«melding»:null
}
RTC (sanntidsklokke) 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åledataverdien som er nærmest den angitte datoen (2025-6-16), som betyr det nærmeste registrerte tidspunktet.
Merk: Disse API-ene er de samme som i forrige kapittel, bare noen flere parametere lagt til.
Returner de historiske dataene for det angitte intervallet og tidsområdet.
Umiddelbar data er i 1 min intervall. Det er 60*24=1440 databiter per dag. Hvis du ber om historiske data i intervaller på 1 min, kan du bare be om data på 1,39 (2000/1440) dager. Men hvis du ber om dataene innen 5 minutters intervall, kan du be om dataene på nesten 7 dager.
Grunnleggende (meterdataliste):https://www.iammeter.com/api/v1/site/meterdatalist/
**Avansert(meterdataliste2):**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 på nett iIAMMETER SwaggerUI målerdataogIAMMETER SwaggerUI meterdata2
Navn | Type | Eksempel | |
---|---|---|---|
Token | String | xxx | nødvendig |
intervall | Antall | 300 | nødvendig, enhet: sekund |
starttid | streng | 2023-09-01 | nødvendig |
sluttid | streng | 2023-09-07 | nødvendig |
Data:[spenning, strøm, strøm, import energi, eksport 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"
]
],
"vellykket": sant,
"melding": null
}
{
"data": [
[
230,//faseA spenning
0,//gjeldende
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"
]
],
"vellykket": sant,
"melding": null
}
{
«data»:[
{ //første data
«rtcTime»:»2023/9/1 0:00:22»,
«gmtTime»:»2023/8/31 16:00:22»,
«verdier»:[
[ //fase A 235,2,//spenning 0,03,//strøm 4,//aktiv effekt 0,57,//effektfaktor 210,21,//import kWh
0 //eksporterte 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»,
«verdier»:[
[ 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»,
«verdier»:[
[
235,6,
0,03,
4,
0,57,
210,27,
0
],
[
5,5,
0,
0,
0,
0,
0
],
[
3,4,
0,
0,
0,
0,
0
]
]
}
],
«vellykket»: sann,
«melding»: null
}
Returner effektanalyseresultatet innen angitt tid.
Ikke ring denne API-en mer enn 5 ganger på en dag.
URL:https://www.iammeter.com/api/v1/site/powerAnalysis
Metode: få
Grense: Vennligst ikke be om denne APIen per SN mer enn 5 ganger hver dag.
Navn | Type | Eksempel | |
---|---|---|---|
sn |
String | xxx | nødvendig |
starttid |
String | 2023-09-01 | valgfri |
sluttid |
String | 2023-09-07 | valgfri |
Merk:
gjennomsnitt: gjennomsnittlig effektavlesning i løpet av denne tidsperioden.
gjennomsnittlig dagtid: gjennomsnittlig strømavlesning på dagtid (08:00–20:00) i løpet av denne tidsperioden.
minimum: minimum effektavlesning i løpet av dette tidsrommet.
maksimum: maksimal effektavlesning i løpet av dette tidsrommet.
{
"data": {
"starttid": "2023-09-01",
"sluttid": "2023-09-07",
"gjennomsnittlig": 862,6,
"gjennomsnittlig dagtid": 836,9,
"minimum": 259,0,
"maksimum": 3999,0
},
"vellykket": sant,
"melding": null
}
Returner effektanalyseresultatet for de siste 7 dagene.
Returner effektanalyseresultatet for den angitte dagen
Returner frakoblingsstatusen med antatt SN i angitt tid.
Ikke ring denne API-en mer enn 5 ganger på en dag.
URL:https://www.iammeter.com/api/v1/site/offlineAnalysis
Metode:Få
Grense: Vennligst ikke be om denne APIen per SN mer enn 5 ganger hver dag.
Navn | Type | Eksempel | |
---|---|---|---|
sn |
String | xxxx | nødvendig |
starttid |
String | 2023-09-01 | valgfri |
sluttid |
String | 2023-09-07 | valgfri |
intervall (enhet :minutt) |
Tall | 5 | valgfri |
Merk:
Det er totalt 10080 minutter i denne tidsperioden.
Den totale frakoblede tiden er 906 minutter i denne tidsperioden.
Frakoblet gap som er større enn 5 minutter er oppført i matrisen.
{
"data": {
"starttid": "2023-09-05",
"sluttid": "2023-09-11",
"offlineCount": 906,
"totalCount": 10080,
"liste": [
{
"starttid": "2023/9/5 0:00:00",
"sluttid": "2023/9/5 15:06:14",
"varighet": 906
}
]
},
"vellykket": sant,
"melding": null
}
Returner frakoblet analyseresultat for den angitte dagen
Returner den siste verdien av hele energimåleren på denne kontoen.
URL:https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Metode:Få
Grense: Sørg for at du ikke sender forespørsler til denne APIen oftere enn én gang hvert 5. minutt.
Navn | Type | Eksempel | |
---|---|---|---|
Token | String | xxx | nødvendig |
{
"data":[
{
"sn":"DA2BED94",
"verdier":[
223,71,
1,74,
225,
14761.03,
0
],
"gmtTime":"2024/2/22 3:46:20"
},
{
"sn":"B384789C",
"verdier":[
[
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",
"verdier":[
[
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",
"verdier":[
[
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",
"verdier":[
[
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"
}
],
"vellykket":true,
"melding":null
}
Hent de timelige/daglige kWh-verdiene for invertergenerering og nettutveksling (både eksportert og importert)
URL:https://www.iammeter.com/api/v1/site/energyhistory/?starttid={2024-05-05}&sluttid={2024-07-07}&gruppe av=&Token={2be6d1xxxxxxcc688}
Metode: få
Grense:
gruppeby = dag :90 dager data (90 stk data)
gruppeby = time :7 dager data (168 stk data)
Navn | Type | Des | Eksempel | |
---|---|---|---|---|
Token | String | token for konto | xxx | nødvendig |
sted_ID | Antall | ID for stedet | nødvendig | |
starttid | streng | starttidspunkt for denne API-retur | 2023-09-01 | nødvendig |
sluttid | streng | stopptid for denne API-retur | 2023-09-07 | nødvendig |
gruppehy | enum | velg returdataintervall (time/dag) | dag/time | nødvendig |
Steds-ID: Mine steder->Rediger
steds-id:1360
starttid=2024-05-05
slutttid=2024-05-07
gruppeby=dag
{
"data": [{
"tid": "2024/5/5 0:00:00",
"avkastning": 0,
"fromGrid": 9,62,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/6 0:00:00",
"avkastning": 0,
"fromGrid": 9.16,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
}
],
"vellykket": sant,
"melding": null
}
steds-id:2393
starttid=2024-05-05
slutttid=2024-05-07
gruppeby=dag
{
"data": [{
"tid": "2024/5/5 0:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/6 0:00:00",
"utbytte": 0,1,
"fromGrid": 0,22,
"toGrid": 7.15,
"spesiell last": 0,
"selvbruk": 0
}
],
"vellykket": sant,
"melding": null
}
steds-id:2393
starttid=2024-05-05
slutttid=2024-05-06
gruppevis = time
{
"data": [{
"tid": "2024/5/5 0:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 1:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 2:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 3:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 4:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 5:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 6:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 7:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 8:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 9:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 10:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 11:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 12:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 13:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 14:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 15:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 16:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 17:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 18:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 19:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 20:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 21:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 22:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
},
{
"tid": "2024/5/5 23:00:00",
"avkastning": 0,
"fromGrid": 0,
"toGrid": 0,
"spesiell last": 0,
"selvbruk": 0
}
],
"vellykket": sant,
"melding": null
}
Hvilke funksjoner tilbyr IAMMETER?
Hvilken type elektrisk måler passer best til dine behov?
Hvordan finner du strømmåleren med hensyn til dine behov
Trefase Wi-Fi energimåler (WEM3080T)
Enfase Wi-Fi energimåler (WEM3080)
Trefase Wi-Fi energimåler (WEM3046T)
Trefase Wi-Fi energimåler (WEM3050T)