Hur använder IAMMETER-molnet mer effektivt av API

Premiss

IAMMETER-molnet tillhandahåller några API:er, och utvecklaren kan använda dessa API:er för att göra en del intressant arbete, som att integrera IAMMETERs data till något tredjepartssystem. Vi har precis öppnat dessa API:er för våra affärspartners och några stora kunder tidigare, men beslutade att öppna dem för alla våra kunder nu.

Välkommen att berätta för oss dina tankar på vårt forum.https://imeter.club

Gräns för API

API:t kan inte besökas obegränsat, vi kommer att begränsa antalet dagliga samtal för varje API. Ring inte API oftare.

Om antalet samtal överskrider tim- eller dagliga begränsningar kommer API:et att returnera ingenting.

Konto: Få kontots token

Returnera token för kontot. Token kommer att användas i nästan alla API.

Du behöver inte anropa detta API om du inte vill uppdatera token.Anrop inte detta API mer än 5 gånger på en timme och inte mer än 30 gånger på en dag.

URL och metod

Få token för kontot som används i alla API:er.

URL:https://www.iammeter.com/api/v1/user/login

Metod:posta

Data

Svar

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

{
    "data": {
        "id": 2025,
        "token": "349dfxxxxxxac5169",
        "refreshToken": "8adf75e5da10424985f3b83855133982"
    },
    "framgångsrik": sant,
    "meddelande": null
}

Få token från webbsystemet direkt

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

Energimätare: Få de senaste uppladdningsdata och UTC-tiden

Få den senaste uppladdningsdatan med den angivna SN.

Ring inte detta API mer än 12 gånger på en timme.

URL och metod

Basic(meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}

Avancerat(meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}

Metod: SKAFFA SIG

Begränsa: begär inte detta API mer än 288 gånger varje dag (5 minuters intervall).

Skillnaden mellan grundläggande och avancerad:

Basic: utan PF (effektfaktor)

Avancerat: med PF (effektfaktor)

Parametrar

Svar: enfas -mätardata (utan effektfaktor)

värdedefinition: spänning, ström, aktiv effekt, importerad Kwh, exporterad Kwh

{
    "data": {
        "värden": [
            [
                230.220,
                1 300,
                119 000,
                1766.590,
                0,000
            ]
        ],
        "lokal tid": "2020/8/28 15:27:33",
        "gmtTime": "2020/8/28 5:27:33"
    },
    "framgångsrik": sant,
    "meddelande": null
}

Svar: enfas -meterdata2 (utan effektfaktor)

värdedefinition: spänning, ström, aktiv effekt,effektfaktor,importerad Kwh, exporterad Kwh

{
    "data":{
        "värden":[
            [
                233,41,
                0,718,
                111,
                0,66,
                5724.85,
                0
            ]
        ],
        "localTime":"2023/11/21 14:30:22",
        "gmtTime":"2023/11/21 6:30:22"
    },
    "framgångsrik":sant,
    "meddelande":null
}

Svar: 3-fas -mätardata (utan effektfaktor)

De tre arrayerna ivärdenrepresenterar fas A, fas B och fas C.

Elementdefinition: spänning, ström, aktiv effekt,effektfaktor,importerad Kwh, exporterad Kwh

{
    "data": {
        "värden": [
            [
                242.600,
                1 000,
                216 000,
                32354.600,
                0,000
            ],
            [
                242.600,
                1 000,
                1986 000,
                30536.410,
                17704.720
            ],
            [
                0,000,
                0,000,
                0,000,
                0,000,
                0,000
            ]
        ],
        "lokal tid": "2020/8/28 15:30:48",
        "gmtTime": "2020/8/28 5:30:48"
    },
    "framgångsrik": sant,
    "meddelande": null
}

Svar: 3-fas -meterdata2(med effektfaktor)

{
    "data":{
        "värden":[
            [//fas A
                233,8,//spänning
                0,03,//ström
                4,//aktiv effekt
                0,57,//effektfaktor
                222,53,//importerad Kwh
                0 //exporterade Kwh
            ],
            [//fas B
                5,
                0,
                0,
                0,
                0,
                0
            ],
            [ //fas C
                3.1,
                0,
                0,
                0,
                0,
                0
            ]
        ],
        "localTime":"2023/11/21 14:39:36",
        "gmtTime":"2023/11/21 6:39:36"
    },
    "framgångsrik":sant,
    "meddelande":null
}

Exempel

Energimätare: Hämta historikrekordet

Returnera historiska data för det inställda intervallet och tidsintervallet.

• tidsintervall: senaste månaden
• maximal datalängd: 2000 stycken

Omedelbar data är i 1 min intervall. Det finns 60*24=1440 databitar per dag. Om du begär historiska data i 1 min intervall kan du bara begära data på 1,39(2000/1440) dagar. Men om du begär data med 5 minuters intervall kan du begära data på nästan 7 dagar.

URL och metod

Grundläggande (mätdatalista):https://www.iammeter.com/api/v1/site/meterdatalist/

**Avancerat(meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}

Skillnaden mellan grundläggande och avancerad:

Basic: utan PF (effektfaktor)

Avancerat: med PF (effektfaktor)

Parametrar

Svar: enfas - mätdatalista

Data:[spänning, ström, effekt, importenergi, exportenergi, 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"
        ]
    ],
    "framgångsrik": sant,
    "meddelande": null
}

Svar: trefas - mätdatalista

{
    "data": [
        [
            230,//fasA spänning
            0,//ström
            0,//aktiv effekt
            468,41,//importerad kWh
            0,//exporterad kWh
            230,//FasB
            0,
            0,
            236,58,
            290,77,
            230,//Fas 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"
        ]
    ],
    "framgångsrik": sant,
    "meddelande": null
}

Svar: trefas - mätdatalista2

{
    "data":[
        {//första data
            "rtcTime":"2023/9/1 0:00:22",
            "gmtTime":"2023/8/31 16:00:22",
            "värden":[
                [ //fas A
                    235,2,//spänning
                    0,03,//ström
                    4,//aktiv effekt
                    0,57,//effektfaktor
                    210,21,//import Kwh
                    0 //exporterade Kwh
                ],
                [//fas B
                    5,5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [ //fas C
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        {//second data
            "rtcTime":"2023/9/1 8:00:49",
            "gmtTime":"2023/9/1 0:00:49",
            "värden":[
                [
                    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ärden":[
                [
                    235,6,
                    0,03,
                    4,
                    0,57,
                    210,27,
                    0
                ],
                [
                    5,5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [
                    3.4,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        }
    ],
    "framgångsrik":sant,
    "meddelande":null
}

Exempel

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

Energimätare: Effektavläsningsanalys

Returnera effektanalysresultatet inom angiven tid.

Ring inte detta API mer än 5 gånger på en dag.

URL och metod

URL:https://www.iammeter.com/api/v1/site/powerAnalysis

Metod: skaffa sig

Begränsa: Begär inte detta API per SN mer än 5 gånger varje dag.

Parametrar

Notera:

1. Det maximala tidsintervallet är 7 dagar den senaste månaden.
2. Tidsparametern är valfri, om du inte använder parametern kommer API:et att returnera resultatet för de senaste 7 dagarna.

Svar

medelvärde: medeleffektavläsning under detta tidsintervall.

genomsnittlig dagtid: genomsnittlig effektavläsning på dagtid (8:00–20:00) under detta tidsintervall.

minimum: lägsta effektavläsning under detta tidsintervall.

maximum: maximal effektavläsning under detta tidsintervall.

{
    "data": {
        "starttid": "2023-09-01",
        "sluttid": "2023-09-07",
        "medelvärde": 862,6,
        "genomsnittlig dagtid": 836,9,
        "minimum": 259,0,
        "maximum": 3999,0
    },
    "framgångsrik": sant,
    "meddelande": null
}

Exempel

Returnera effektanalysresultatet för de senaste 7 dagarna.

Returnera effektanalysresultatet för den angivna dagen

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

Energimätare: Off-line statusanalys

Återställ frånkopplingsstatus med ansett SN inom angiven tid.

Ring inte detta API mer än 5 gånger på en dag.

URL och metod

URL：https://www.iammeter.com/api/v1/site/offlineAnalysis

Metod：Skaffa sig

Begränsa: Begär inte detta API per SN mer än 5 gånger varje dag.

Parametrar

Notera:

1. Det maximala tidsintervallet är 7 dagar den senaste månaden.
2. Tidsparametern är valfri, om du inte använder parametern kommer API:et att returnera resultatet för de senaste 7 dagarna.
3. Om du inte anger intervallet är standardvärdet 5 minuter.

Svar

Det finns totalt 10080 minuter inom detta tidsintervall.

Den totala offlinetiden är 906 minuter inom detta tidsintervall.

Offlinegapet som är större än 5 minuter listas i arrayen.

{
    "data": {
        "starttid": "2023-09-05",
        "sluttid": "2023-09-11",
        "offlineCount": 906,
        "totalCount": 10080,
        "lista": [
            {
                "starttid": "2023/9/5 0:00:00",
                "sluttid": "2023/9/5 15:06:14",
                "varaktighet": 906
            }
        ]
    },
    "framgångsrik": sant,
    "meddelande": null
}

Exempel

Returnera offlineanalysresultatet för den angivna dagen

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

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

Returnera det senaste värdet för all energimätare på detta konto.

URL och metod

URL：https://www.iammeter.com/api/v1/site/metersdata?token=xxx

Metod：Skaffa sig

Begränsa: Se till att du inte gör förfrågningar till detta API oftare än en gång var 5:e minut.

Parametrar

Svar

{
    "data":[
        {
            "sn":"DA2BED94",
            "värden":[
                223,71,
                1,74,
                225,
                14761.03,
                0
            ],
            "gmtTime":"2024/2/22 3:46:20"
        },
        {
            "sn":"B384789C",
            "värden":[
                [
                    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",
            "värden":[
                [
                    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ärden":[
                [
                    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",
            "värden":[
                [
                    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"
        }
    ],
    "framgångsrik":sant,
    "meddelande":null
}

Exempel

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

Hämta kWh-värdena per timme/dag för växelriktargenerering och nätutbyte (både exporterade och importerade)

URL och metod

URL：https://www.iammeter.com/api/v1/site/energyhistory/?starttid={2024-05-05}&sluttid={2024-07-07}&Grupp av=&Tecken={2be6d1xxxxxxcc688}

Metod: skaffa sig

Begränsa：

gruppby = dag :90 dagars data (90 st data)

groupby = timme :7 dagar data (168 st data)

Parametrar

Plats_ID: Mina platser->Redigera

Svar: enfas

plats_id:1360

starttid=2024-05-05

sluttid=2024-05-07

gruppby=dag

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

{
	"data": [{
			"tid": "2024/5/5 0:00:00",
			"yield": 0,
			"fromGrid": 9,62,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/6 0:00:00",
			"yield": 0,
			"fromGrid": 9.16,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		}
	],
	"framgångsrik": sant,
	"meddelande": null
}

Svar: tre faser

plats_id:2393

starttid=2024-05-05

sluttid=2024-05-07

gruppby=dag

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

{
	"data": [{
			"tid": "2024/5/5 0:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/6 0:00:00",
			"utbyte": 0,1,
			"fromGrid": 0,22,
			"toGrid": 7,15,
			"specialLoad": 0,
			"självanvändning": 0
		}
	],
	"framgångsrik": sant,
	"meddelande": null
}

plats_id:2393

starttid=2024-05-05

sluttid=2024-05-06

gruppvis = timme

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

{
	"data": [{
			"tid": "2024/5/5 0:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 1:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 2:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 3:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 4:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 5:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 6:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 7:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 8:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 9:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 10:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 11:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 12:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 13:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 14:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 15:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 16:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 17:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 18:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 19:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 20:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 21:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 22:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		},
		{
			"tid": "2024/5/5 23:00:00",
			"yield": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"specialLoad": 0,
			"självanvändning": 0
		}
	],
	"framgångsrik": sant,
	"meddelande": null
}

Referens

API för WiFi-energimätaren

Vilka funktioner erbjuder IAMMETER?

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

Hur hittar du effektmätaren med hänsyn till dina krav

Använd 3-fas energimätaren på det sätt du föredrar

3 fas WiFi energimätare