Tyvärr stöder din webbläsare inte JavaScript!
Logga in

Hur du använder IAMMETER-cloud mer effektivt via API:et

Förutsättningar

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

Gräns för API

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

Konto: Hämta kontots token

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.

URL och metod

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

Data

Nr. parameter anmärkning exempel
1 user name Användarnamn för IAMMETER test
2 password lösenord för IAMMETER 123456

Svar

Tokenvärdet kommer att användas i alla API:er nedan.

{
    "data": {
        "id": 2025,
        "token": "349dfxxxxxxac5169",
        "refreshToken": "8adf75e5da10424985f3b83855133982"
    },
    "successful": true,
    "message": null
}

Hämta tokenen direkt från webbsystemet

Denna token kan också läsas direkt efter att du har loggat in i systemet.

image-20230921163110697

Energimätare: Hämta senaste uppladdade data och UTC-tiden

Hämtar den senast uppladdade datan med den aktuella SN.

Anropa inte detta API mer än 12 gånger under en timme.

URL och metod

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)

Parametrar

Namn Typ Exempel
Token String xxx obligatorisk
rtctime string 2025-6-16 valfri

Svar: enfas -meterdata (utan effektfaktor)

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
}

Svar: enfas -meterdata2 (med effektfaktor)

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
}

Svar: 3-fas -meterdata (utan effektfaktor)

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
}

Svar: 3-fas -meterdata2 (med effektfaktor)

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
}

Exempel (hämta senaste uppladdningsvärdet)

image-20230921164457116

Exempel (hämta värdet nära en specifik RTC-tid)

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.

Energimätare: Hämta historik

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.

  • tidsperiod: senaste månaden
  • maximal datalängd: 2000 poster

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.

URL och metod

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

Parametrar

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

Svar: enfas - meterdatalist

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
}

Svar: trefas - meterdatalist

{
    "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
}

Svar: trefas - meterdatalist2

{
    "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
}

Exempel

https://www.iammeter.com/api/v1/Site/MeterDataList/{yourSN}?token={yourToken}&startTime=2023-09-01&endTime=2023-09-07&interval=300

image-20230926150649591

Energimätare: Analys av effektavläsning

Returnerar effektanalysresultatet för den angivna tiden.

Anropa inte detta API mer än 5 gånger under ett dygn.

URL och metod

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.

Parametrar

Namn Typ Exempel
sn String xxx obligatorisk
startTime String 2023-09-01 valfri
endTime String 2023-09-07 valfri

Obs:

  1. Den maximala tidsperioden är 7 dygn inom den senaste månaden.
  2. Tidsparametern är valfri; om du inte använder parametern returnerar API:et resultatet för de senaste 7 dygnen.

Svar

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
}

Exempel

Returnera effektanalysresultatet för de senaste 7 dygnen.

image-20230921163444898

Returnera effektanalysresultatet för en angiven dag

https://www.iammeter.com/api/v1/site/powerAnalysis?token={YourToken}&sn={YourSN}&starttime=2023-09-21&endtime=2023-09-21

image-20230922101047074

Energimätare: Analys av frånkopplingsstatus

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 och metod

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.

Parametrar

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:

  1. Den maximala tidsperioden är 7 dygn inom den senaste månaden.
  2. Tidsparametern är valfri; om du inte använder parametern returnerar API:et resultatet för de senaste 7 dygnen.
  3. Om du inte anger intervallet är standardvärdet 5 minuter.

Svar

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
}

Exempel

Returnera frånkopplingsanalysresultatet för en angiven dag

https://www.iammeter.com/api/v1/site/offlineAnalysis?token={YourToken}&sn={YourSN}&starttime=2023-09-21&endtime=2023-09-21

image-20230922101653639

Konto: hämta senaste data från alla energimätare inom ett konto

Returnerar det senaste värdet för alla energimätare i detta konto.

URL och metod

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.

Parametrar

Namn Typ Exempel
Token String xxx obligatorisk

Svar

{
    "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
}

Exempel

image-20240222114848312

Plats: Returnera tim- eller dygnsvisa kWh-data för varje användningstyp.

Hämtar tim-/dygnsvärdena för kWh för växelriktarens produktion och nätutbyte (både exporterad och importerad)

URL och metod

URL: https://www.iammeter.com/api/v1/site/energyhistory/{plcae_ID}?**startTime**={2024-05-05}&**endTime**={2024-07-07}&**groupby**={day}&**Token**={2be6d1xxxxxxcc688}

Metod: get

Begränsning:

groupby = day :90 dagars data (90 poster)

groupby = hour :7 dagars data (168 poster)

Parametrar

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

Svar: enfas

place_id:1360

startTime=2024-05-05

endTime=2024-05-07

groupby=day

https://www.iammeter.com/api/v1/site/energyhistory/1360?startTime=2024-05-05&endTime=2024-05-07&groupby=day&Token=f7eba1ac8c194b3fbc8e79b8af0adb72

{
	"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
}

Svar: trefas

place_id:2393

startTime=2024-05-05

endTime=2024-05-07

groupby=day

https://www.iammeter.com/api/v1/site/energyhistory/2393?startTime=2024-05-05&endTime=2024-05-07&groupby=day&Token=f7eba1ac8c194b3fbc8e79b8af0adb72

{
	"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

https://www.iammeter.com/api/v1/site/energyhistory/2393?startTime=2024-05-05&endTime=2024-05-07&groupby=day&Token=f7eba1ac8c194b3fbc8e79b8af0adb72

{
	"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
}

Referens

API för WiFi-energimätaren

Vilka funktioner erbjuder IAMMETER?

Vilken typ av elmätare passar bäst dina behov?

Hur hittar du kraftmätaren utifrån dina krav

Använd 3-fas energimätaren som du föredrar

3-fas WiFi-energimätare

Upp