IAMMETER-cloud giver nogle API'er, og udvikleren kan bruge disse API'er til at udføre noget interessant arbejde, såsom at integrere IAMMETERs data til et tredjepartssystem. Vi har lige åbnet disse API'er for vores forretningspartnere og nogle store kunder før, men besluttede at åbne dem for alle vores kunder nu.
Velkommen til at fortælle os om dine tanker på vores forum.https://imeter.club
API'en kan ikke besøges ubegrænset, vi vil begrænse det daglige opkaldstal for hver API. Venligst ikke kalde API'en oftere.
Hvis antallet af opkald overstiger time- eller daglig begrænsning, returnerer API'en intet.
| Ingen. | API | grænsetype | Hver time | Daglige | Beskrivelse |
|---|---|---|---|---|---|
| 1 | /bruger/login | ip | 5 | 30 | én IP må kun kalde dette api 5 gange i timen |
| 2 | /site/målerdata/ | SN | 12 | en SN må kun kalde dette api 12 gange i timen | |
| 3 | /site/powerAnalysis | SN | 5 | en SN må kun kalde dette api 5 gange dagligt | |
| 4 | /site/offlineAnalyse | SN | 5 | en SN må kun kalde dette api 5 gange dagligt |
Returner kontoens token. Tokenet vil blive brugt i næsten hele API'en.
Du behøver ikke kalde denne API, medmindre du vil opdatere tokenet.Ring venligst ikke denne API mere end 5 gange på en time og ikke mere end 30 gange på en dag.
Få tokenet for kontoen, som bruges i alle API'er.
URL:https://www.iammeter.com/api/v1/user/login
Metode:stolpe
Denne API kan testes online iIAMMETER SwaggerUI hent token
| Ingen. | parameter | Bemærkning | Eksempel |
|---|---|---|---|
| 1 | brugernavn | Brugernavn på IAMMETER | prøve |
| 2 | Adgangskode | adgangskode til IAMMETER | 123456 |
Tokenværdien vil blive brugt i alle nedenstående API'er.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"vellykket": sandt,
"meddelelse": null
}Dette token kan også læses direkte efter du har logget på systemet.
Hent de sidste uploaddata med den betragtede SN.
Ring venligst ikke denne API mere end 12 gange på en time.
Grundlæggende (målerdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Denne API kan testes online iIAMMETER SwaggerUI
Avanceret(målerdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Denne API kan testes online iIAMMETER SwaggerUI målerdataogIAMMETER SwaggerUI meterdata2
Metode: FÅ
Begrænse: anmod venligst ikke om denne API mere end 288 gange hver dag (5 minutters interval).
Forskellen mellem grundlæggende og avanceret:
Grundlæggende: uden PF (effektfaktor)
Avanceret: med PF (Power factor)
| navn | Type | Eksempel | |
|---|---|---|---|
| Polet | Snor | xxx | påkrævet |
| rtc-tid | Snor | 2025-6-16 | valgfri |
værdier definition: spænding, strøm, aktiv effekt, importeret Kwh, eksporteret Kwh
{
"data": {
"værdier": [
[
230,220, //spænding
1,300, //strøm
119,000, //aktiv effekt
1766,590, //importeret kWh
0,000 //eksporteret kWh
]
],
"lokaltid": "2020/8/28 15:27:33",
"gmttid": "2020/8/28 5:27:33"
},
"lykkedes": sand,
"besked": null
}værdier definition: spænding, strøm, aktiv effekt,magtfaktorimporterede kWh, eksporterede kWh.
Selvom vi erkender, at det ikke er optimalt at placere effektfaktoren mellem aktiv effekt og importeret energi, er det nuværende format allerede sat op på denne måde – vær opmærksom på denne ordning.
{
"data":{
"værdier":[
[
233,41, //spænding
0,718, //strøm
111, //aktiv effekt
0,66, //effektfaktor
5724,85, //importeret energi
0 //eksporteret energi
]
],
"lokaltid": "2023/11/21 14:30:22",
"gmttid": "2023/11/21 6:30:22"
},
"lykkedes": sand,
"besked": nul
}De tre arrays iværdierrepræsenterer fase A, fase B og fase C.
værdier definition: spænding, strøm, aktiv effekt, importeret Kwh, eksporteret Kwh
{
"data": {
"værdier": [
[
242,600,//spænding 1,000,//strøm 216,000,//aktiv effekt 32354,600,//importeret energi 0,000//eksporteret 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"
},
"lykkedes": sand,
"besked": null
}Element definition: spænding, strøm, aktiv effekt,magtfaktor,importeret Kwh, eksporteret Kwh
{
"data":{
"værdier":[
[//fase A
233,8,//spænding
0,03,//strøm
4,//aktiv effekt
0,57,//effektfaktor
222,53,//importerede Kwh
0 //eksporteret Kwh
],
[//fase B
5,
0,
0,
0,
0,
0
],
[ //fase C
3.1,
0,
0,
0,
0,
0
]
],
"lokal tid":"2023/11/21 14:39:36",
"gmtTime":"2023/11/21 6:39:36"
},
"succesfuld":sandt,
"besked":null
}
RTC (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-16Denne anmodning returnerer den uploadede målerdataværdi, der er tættest på den angivne dato (2025-6-16), hvilket betyder det nærmeste registrerede tidspunkt.
Bemærk: Disse API'er er de samme som i det foregående kapitel, blot tilføjet nogle flere parametre
Returner de historiske data på det indstillede interval og tidsinterval.
De øjeblikkelige data er i 1 min interval. Der er 60*24=1440 stykker data pr. dag. Hvis du anmoder om de historiske data i 1 min. interval, kan du kun anmode om data på 1,39(2000/1440) dage. Men hvis du anmoder om data i 5 minutters interval, kan du anmode om data på næsten 7 dage.
Grundlæggende (målerdataliste):https://www.iammeter.com/api/v1/site/meterdatalist/
**Avanceret(meterdataliste2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Forskellen mellem grundlæggende og avanceret:
Grundlæggende: uden PF (effektfaktor)
Avanceret: med PF (Power factor)
Denne API kan testes online iIAMMETER SwaggerUI målerdataogIAMMETER SwaggerUI meterdata2
| navn | Type | Eksempel | |
|---|---|---|---|
| Polet | Snor | xxx | påkrævet |
| interval | nummer | 300 | påkrævet, enhed: sekund |
| starttidspunkt | Snor | 2023-09-01 | påkrævet |
| sluttid | Snor | 2023-09-07 | påkrævet |
Data:[spænding, 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": sandt,
"meddelelse": null
}{
"data": [
[
230,//faseA spænding
0,//aktuel
0,//aktiv effekt
468,41,//importeret kWh
0,//eksporteret 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": sandt,
"meddelelse": null
}{
"data":[
{//første data
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"værdier":[
[ //fase A
235,2,//spænding
0,03,//strøm
4,//aktiv effekt
0,57,//effektfaktor
210,21,//import Kwh
0 //eksporteret Kwh
],
[//fase B
5,5,
0,
0,
0,
0,
0
],
[ //fase C
3.3,
0,
0,
0,
0,
0
]
]
},
{//sekund data
"rtcTime":"2023/9/1 8:00:49",
"gmtTime":"2023/9/1 0:00:49",
"værdier":[
[
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",
"værdier":[
[
235,6,
0,03,
4,
0,57,
210,27,
0
],
[
5,5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
"succesfuld":sandt,
"besked":null
}
Returner effektanalyseresultatet inden for den angivne tid.
Ring venligst ikke denne API mere end 5 gange på en dag.
url:https://www.iammeter.com/api/v1/site/powerAnalysis
Metode: FÅ
Begrænse: Anmod venligst ikke om denne API pr. SN mere end 5 gange hver dag.
| navn | Type | Eksempel | |
|---|---|---|---|
SN |
Snor | xxx | påkrævet |
starttidspunkt |
Snor | 2023-09-01 | valgfri |
sluttid |
Snor | 2023-09-07 | valgfri |
Bemærk:
gennemsnit: gennemsnitlig effektaflæsning i dette tidsinterval.
gennemsnitlig dagtid: gennemsnitlig effektaflæsning i dagtimerne (8:00-20:00) i dette tidsinterval.
minimum: minimum effektaflæsning i dette tidsinterval.
maksimum: maksimal effektaflæsning i dette tidsinterval.
{
"data": {
"starttid": "2023-09-01",
"sluttidspunkt": "2023-09-07",
"gennemsnit": 862,6,
"gennemsnitlig dagtid": 836,9,
"minimum": 259,0,
"maksimum": 3999,0
},
"vellykket": sandt,
"meddelelse": null
}Returner effektanalyseresultatet for de sidste 7 dage.
Returner effektanalyseresultatet for den angivne dag
Returner afbrydelsesstatus med betragtet SN inden for det angivne tidspunkt.
Ring venligst ikke denne API mere end 5 gange på en dag.
url：https://www.iammeter.com/api/v1/site/offlineAnalysis
Metode：Få
Begrænse: Anmod venligst ikke om denne API pr. SN mere end 5 gange hver dag.
| navn | Type | Eksempel | |
|---|---|---|---|
SN |
Snor | xxxx | påkrævet |
starttidspunkt |
Snor | 2023-09-01 | valgfri |
sluttid |
Snor | 2023-09-07 | valgfri |
interval(enhed :minut) |
nummer | 5 | valgfri |
Bemærk:
Der er i alt 10080 minutter i dette tidsinterval.
Den samlede offlinetid er 906 minutter i dette tidsinterval.
Offlinemellemrummet, der er større end 5 minutter, er angivet i arrayet.
{
"data": {
"starttid": "2023-09-05",
"sluttidspunkt": "2023-09-11",
"offlineCount": 906,
"totalCount": 10080,
"liste": [
{
"starttid": "2023/9/5 0:00:00",
"sluttid": "2023/9/5 15:06:14",
"varighed": 906
}
]
},
"vellykket": sandt,
"meddelelse": null
}Returner offlineanalyseresultatet for den angivne dag
Returner den seneste værdi af hele energimåleren på denne konto.
url：https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Metode：Få
Begrænse: Sørg for, at du ikke sender anmodninger til denne API oftere end én gang hvert 5. minut.
| navn | Type | Eksempel | |
|---|---|---|---|
| Polet | Snor | xxx | påkrævet |
{
"data":[
{
"sn":"DA2BED94",
"værdier":[
223,71,
1,74,
225,
14761.03,
0
],
"gmtTime":"2024/2/22 3:46:20"
},
{
"sn":"B384789C",
"værdier":[
[
248,9,
13,9,
3356,
21228,
0,
nul,
nul
],
[
248,9,
13,9,
-2747,
8988.48,
18489.44,
nul,
nul
],
[
nul,
nul,
nul,
nul,
nul,
nul,
nul
],
[
248,9,
13,9,
-2747,
8988.48,
18489.44,
nul,
nul
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
"sn":"674B1E5D",
"værdier":[
[
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",
"værdier":[
[
245,3,
6,5,
1604,
46055.7,
0,
nul,
nul
],
[
245,3,
6,5,
-910,
15726.73,
8956.56,
nul,
nul
],
[
nul,
nul,
nul,
nul,
nul,
nul,
nul
],
[
245,3,
6,5,
-910,
15726.73,
8956.56,
nul,
nul
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
"sn":"3FE34ABE",
"værdier":[
[
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"
}
],
"succesfuld":sandt,
"besked":null
}
Hent de timelige/daglige kWh-værdier for invertergenerering og netudveksling (både eksporteret og importeret)
url： https://www.iammeter.com/api/v1/site/energyhistory/?starttidspunkt={2024-05-05}&sluttid={2024-07-07}&gruppeby=&Polet={2be6d1xxxxxxcc688}
Metode: FÅ
Begrænse：
gruppeby = dag :90 dage data (90 stk data)
groupby = time :7 dage data (168 stk data)
| navn | Type | Des | Eksempel | |
|---|---|---|---|---|
| Polet | Snor | token på kontoen | xxx | påkrævet |
| sted_ID | nummer | ID på stedet | påkrævet | |
| starttidspunkt | Snor | starttidspunkt for denne API-retur | 2023-09-01 | påkrævet |
| sluttid | Snor | stoptidspunkt for denne API-retur | 2023-09-07 | påkrævet |
| gruppeby | enum | vælg returdatainterval (time/dag) | dag/time | påkrævet |
sted_ID: Mine steder->Rediger
sted_id:1360
starttid=2024-05-05
sluttidspunkt=2024-05-07
gruppeby=dag
{
"data": [{
"tid": "2024/5/5 0:00:00",
"udbytte": 0,
"fromGrid": 9,62,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/6 0:00:00",
"udbytte": 0,
"fromGrid": 9.16,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
}
],
"vellykket": sandt,
"meddelelse": null
}sted_id:2393
starttid=2024-05-05
sluttidspunkt=2024-05-07
gruppeby=dag
{
"data": [{
"tid": "2024/5/5 0:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/6 0:00:00",
"udbytte": 0,1,
"fromGrid": 0,22,
"toGrid": 7,15,
"specialLoad": 0,
"selvbrug": 0
}
],
"vellykket": sandt,
"meddelelse": null
}sted_id:2393
starttid=2024-05-05
sluttidspunkt=2024-05-06
gruppevis = time
{
"data": [{
"tid": "2024/5/5 0:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 1:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 2:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 3:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 4:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 5:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 6:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 7:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 8:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 9:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 10:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 11:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 12:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 13:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 14:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 15:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 16:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 17:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 18:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 19:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 20:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 21:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 22:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
},
{
"tid": "2024/5/5 23:00:00",
"udbytte": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selvbrug": 0
}
],
"vellykket": sandt,
"meddelelse": null
}Hvilke muligheder tilbyder IAMMETER?
Hvilken type elmåler passer bedst til dine behov?
Hvordan finder du strømmåleren i forhold til dine krav
Trefaset Wi-Fi-energimåler (WEM3080T)
Enkeltfaset Wi-Fi-energimåler (WEM3080)
Trefaset Wi-Fi energimåler (WEM3046T)
Trefaset Wi-Fi-energimåler (WEM3050T)