Kako učinkoviteje uporabljati IAMMETER-cloud z API-jem

Predpostavka

Oblak IAMMETER ponuja nekaj API-jev in razvijalec lahko te API-je uporabi za zanimivo delo, kot je integracija podatkov IAMMETER v sistem tretje osebe. Te API-je smo že prej odprli našim poslovnim partnerjem in nekaterim velikim strankam, zdaj pa smo se odločili, da jih odpremo vsem našim strankam.

Dobrodošli, da nam sporočite svoje mnenje na našem forumu.https://imeter.club

Omejitev API-ja

API-ja ni mogoče obiskati neomejeno, omejili bomo dnevno število klicev za vsak API. Prosimo, ne kličite API-ja pogosteje.

Če število klicev preseže urno ali dnevno omejitev, API ne bo vrnil ničesar.

Račun: pridobite žeton računa

Vrnite žeton računa. Žeton bo uporabljen v skoraj vseh API-jih.

Tega API-ja vam ni treba klicati, razen če želite osvežiti žeton.Prosimo, da tega API-ja ne kličete več kot 5-krat v eni uri in ne več kot 30-krat v enem dnevu.

URL&metoda

Pridobite žeton računa, ki se uporablja v vseh API-jih.

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

metoda:post

Ta API je mogoče preizkusiti na spletu vIAMMETER SwaggerUI pridobi žeton

podatki

Odziv

Vrednost žetona bo uporabljena v vseh spodnjih API-jih.

{
    "podatki": {
        "id": 2025,
        "žeton": "349dfxxxxxxac5169",
        "refreshToken": "8adf75e5da10424985f3b83855133982"
    },
    "uspešno": res,
    "sporočilo": nič
}

Pridobite žeton neposredno iz spletnega sistema

Ta žeton je mogoče prebrati tudi neposredno po prijavi v sistem.

Merilnik energije: pridobite najnovejše podatke o nalaganju in čas UTC

Pridobite podatke o zadnjem nalaganju z zadevnim SN.

Prosimo, da tega API-ja ne kličete več kot 12-krat v eni uri.

URL&metoda

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

Ta API je mogoče preizkusiti na spletu vIAMMER SwaggerUI

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

Ta API je mogoče preizkusiti na spletu vPodatki merilnika IAMMETER SwaggerUIinIAMMER SwaggerUI meterdata2

Metoda: DOBITI

Omejitev: ne zahtevajte tega API-ja več kot 288-krat na dan (5-minutni interval).

Razlika med osnovnim in naprednim:

Osnovno: brez PF (faktor moči)

Napredno: s PF (faktor moči)

Parametri

Odziv: enofazni -podatki merilnika (brez faktorja moči)

definicija vrednosti: napetost, tok, aktivna moč, uvožena Kwh, izvožena Kwh

{
"podatki": {
"vrednosti": [
[
230.220, //napetost
1.300, //tok
119.000, //aktivna moč
1766.590, //uvožene kWh
0.000 //izvožene kWh
]
],
"lokalni_čas": "28. 8. 2020 15:27:33",
"gmt_čas": "28. 8. 2020 5:27:33"
},

"uspešno": res,
"sporočilo": nič
}

Odgovor: enofazni -meterdata2 (s faktorjem moči)

definicija vrednosti: napetost, tok, aktivna moč,faktor moči,uvožena kWh, izvožena kWh.

Čeprav se zavedamo, da razporeditev faktorja moči med aktivno močjo in uvoženo energijo ni optimalna, je trenutna oblika že nastavljena na ta način – upoštevajte to ureditev.

{
"podatki":{
"vrednosti":[
[
233,41, //napetost
0,718,//tok
111,//aktivna moč
0,66,//faktor moči
5724,85, //uvožena energija
0 //izvožena energija
]
],
"lokalni čas": "21. 11. 2023 14:30:22",
"gmtčas": "21. 11. 2023 6:30:22"
},
"uspešno":true,
"sporočilo":null
}

Odziv: 3-fazni podatki merilnika (brez faktorja moči)

Trije nizi vvrednotepredstavljajo fazo A, fazo B in fazo C.

definicija vrednosti: napetost, tok, aktivna moč, uvožena Kwh, izvožena Kwh

{
»podatki«: {
»vrednosti«: [
[
242.600,//napetost
1.000,//tok
216.000,//aktivna moč
32354.600,//uvožena energija
0.000//izvožena energija
],

[
242.600,
1.000,
1986.000,
30536.410,
17704.720
],

[
0.000,
0.000,
0.000,
0.000,
0.000
]
],

»lokalni čas«: »2020/8/28 15:30:48«,
»GMTČas«: »28. 8. 2020 5:30:48«
},
»uspešno«: res,
»sporočilo«: nič
}

Odziv: 3 fazni -meter data2 (s faktorjem moči)

Definicija elementa: napetost, tok, aktivna moč,faktor moči,uvoženih Kwh, izvoženih Kwh

{
    "podatki":{
        "vrednosti":[
            [//faza A
                233,8 // napetost
                0,03,//trenutno
                4,//aktivna moč
                0,57,//faktor moči
                222,53,//uvoženih Kwh
                0 //izvoženih Kwh
            ],
            [//faza B
                5,
                0,
                0,
                0,
                0,
                0
            ],
            [ //faza C
                3.1,
                0,
                0,
                0,
                0,
                0
            ]
        ],
        "lokalni čas":"2023/11/21 14:39:36",
        "gmtTime":"2023/11/21 6:39:36"
    },
    "uspešno": res,
    "sporočilo":nič
}

Primer (pridobi najnovejšo vrednost nalaganja)

Primer (pridobi vrednost blizu določenega časa RTC)

RTC (ura realnega časa) je tudi parameter v zahtevi HTTP GET, kot je prikazano spodaj:

https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16

Ta zahteva bo vrnila naloženo vrednost podatkov števca, ki je najbližja določenemu datumu (16. 6. 2025), kar pomeni najbližjo zabeleženo časovno točko.

Merilnik energije: pridobite zapis zgodovine

Opomba: ti API-ji so enaki kot v prejšnjem poglavju, dodanih je le nekaj več parametrov.

Vrne zgodovinske podatke o nastavljenem intervalu in časovnem razponu.

• časovni razpon: zadnji mesec
• največja dolžina podatkov: 2000 kosov

Trenutni podatki so v intervalu 1 min. Na dan je 60*24=1440 podatkov. Če zahtevate zgodovinske podatke v intervalu 1 minute, lahko zahtevate le podatke za 1,39 (2000/1440) dni. Če pa zahtevate podatke v intervalu 5 minut, lahko zahtevate podatke za skoraj 7 dni.

URL&metoda

Osnovno (podatkovnik merilnikov):https://www.iammeter.com/api/v1/site/meterdatalist/

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

Razlika med osnovnim in naprednim:

Osnovno: brez PF (faktor moči)

Napredno: s PF (faktor moči)

Ta API je mogoče preizkusiti na spletu vPodatki merilnika IAMMETER SwaggerUIinIAMMER SwaggerUI meterdata2

Parametri

Odziv: enofazni - merilnik podatkov

Podatki: [napetost, tok, moč, uvoz energije, izvoz energije, UTC čas, lokalni čas]

{
    "podatki": [
        [
            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"
        ]
    ],
    "uspešno": res,
    "sporočilo": nič
}

Odziv: trifazni - merilnik podatkov

{
    "podatki": [
        [
            230,//napetost faze A
            0,//trenutno
            0,//aktivna moč
            468,41,//uvoženih kWh
            0,//izvoženih kWh
            230,//FazaB
            0,
            0,
            236,58,
            290,77,
            230, // Faza 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"
        ]
    ],
    "uspešno": res,
    "sporočilo": nič
}

Odziv: trifazni - meterdatalist2

{
    "podatki":[
        { //prvi podatki
            "rtcTime":"2023/9/1 0:00:22",
            "gmtTime":"2023/8/31 16:00:22",
            "vrednosti":[
                [ //faza A
                    235.2, // napetost
                    0,03,//trenutno
                    4,//aktivna moč
                    0,57,//faktor moči
                    210.21,//uvoz Kwh
                    0 //izvoženih Kwh
                ],
                [//faza B
                    5,5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [ //faza C
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        { //drugi podatek
            "rtcTime":"2023/9/1 8:00:49",
            "gmtTime":"2023/9/1 0:00:49",
            "vrednosti":[
                [
                    233,4,
                    0,03,
                    4,
                    0,57,
                    210,24,
                    0
                ],
                [
                    5.4,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        { //tretji podatek
            "rtcTime":"2023/9/1 16:00:24",
            "gmtTime":"2023/9/1 8:00:24",
            "vrednosti":[
                [
                    235,6,
                    0,03,
                    4,
                    0,57,
                    210,27,
                    0
                ],
                [
                    5,5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [
                    3.4,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        }
    ],
    "uspešno": res,
    "sporočilo":nič
}

Primer

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

Merilnik energije: Analiza odčitka moči

Vrnite rezultat analize moči v določenem času.

Prosimo, da tega API-ja ne kličete več kot 5-krat v enem dnevu.

URL&metoda

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

Metoda: DOBITI

Omejitev: Prosimo, ne zahtevajte tega API-ja na SN več kot 5-krat na dan.

Parametri

Opomba:

1. Največji časovni razpon je 7 dni v zadnjem mesecu.
2. Časovni parameter ni obvezen, če parametra ne uporabite, bo API vrnil rezultat zadnjih 7 dni.

Odziv

povprečje: povprečni odčitek moči v tem časovnem območju.

povprečni dnevni čas: povprečni dnevni (8:00 do 20:00) odčitek moči v tem časovnem razponu.

minimum: odčitek najmanjše moči v tem časovnem območju.

maksimum: največji odčitek moči v tem časovnem območju.

{
    "podatki": {
        "začetni čas": "2023-09-01",
        "konec": "2023-09-07",
        "povprečje": 862,6,
        "povprečni dnevni čas": 836,9,
        "najmanj": 259,0,
        "največ": 3999,0
    },
    "uspešno": res,
    "sporočilo": nič
}

Primer

Vrni rezultat analize moči zadnjih 7 dni.

Vrni rezultat analize moči določenega dne

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

Merilnik energije: Analiza stanja brez povezave

Vrni status odklopa z obravnavanim SN v navedenem času.

Prosimo, da tega API-ja ne kličete več kot 5-krat v enem dnevu.

URL&metoda

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

Metoda：Dobiti

Omejitev: Prosimo, ne zahtevajte tega API-ja na SN več kot 5-krat na dan.

Parametri

Opomba:

1. Največji časovni razpon je 7 dni v zadnjem mesecu.
2. Časovni parameter ni obvezen, če parametra ne uporabite, bo API vrnil rezultat zadnjih 7 dni.
3. Če intervala ne določite, je privzeta vrednost 5 minut.

Odziv

V tem časovnem razponu je skupaj 10080 minut.

Skupni čas brez povezave je 906 minut v tem časovnem razponu.

Vrzel brez povezave, ki je večja od 5 minut, je navedena v matriki.

{
    "podatki": {
        "začetni čas": "2023-09-05",
        "končni čas": "2023-09-11",
        "offlineCount": 906,
        "totalCount": 10080,
        "seznam": [
            {
                "začetni čas": "2023/9/5 0:00:00",
                "konec": "2023/9/5 15:06:14",
                "trajanje": 906
            }
        ]
    },
    "uspešno": res,
    "sporočilo": nič
}

Primer

Vrni rezultat analize brez povezave za navedeni dan

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

Račun: pridobite najnovejše podatke iz vseh števcev energije znotraj enega računa

Vrni zadnjo vrednost vseh števcev energije v tem računu.

URL&metoda

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

Metoda：Dobiti

Omejitev: Prepričajte se, da tega API-ja ne zahtevate pogosteje kot enkrat na 5 minut.

Parametri

Odziv

{
    "podatki":[
        {
            "sn":"DA2BED94",
            "vrednosti":[
                223,71,
                1,74,
                225,
                14761.03,
                0
            ],
            "gmtTime":"2024/2/22 3:46:20"
        },
        {
            "sn":"B384789C",
            "vrednosti":[
                [
                    248,9,
                    13.9,
                    3356,
                    21228,
                    0,
                    nič,
                    nič
                ],
                [
                    248,9,
                    13.9,
                    -2747,
                    8988,48,
                    18489,44,
                    nič,
                    nič
                ],
                [
                    nič,
                    nič,
                    nič,
                    nič,
                    nič,
                    nič,
                    nič
                ],
                [
                    248,9,
                    13.9,
                    -2747,
                    8988,48,
                    18489,44,
                    nič,
                    nič
                ]
            ],
            "gmtTime":"2024/2/22 3:45:15"
        },
        {
            "sn":"674B1E5D",
            "vrednosti":[
                [
                    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",
            "vrednosti":[
                [
                    245,3,
                    6,5,
                    1604,
                    46055.7,
                    0,
                    nič,
                    nič
                ],
                [
                    245,3,
                    6,5,
                    -910,
                    15726,73,
                    8956,56,
                    nič,
                    nič
                ],
                [
                    nič,
                    nič,
                    nič,
                    nič,
                    nič,
                    nič,
                    nič
                ],
                [
                    245,3,
                    6,5,
                    -910,
                    15726,73,
                    8956,56,
                    nič,
                    nič
                ]
            ],
            "gmtTime":"2024/2/22 3:45:15"
        },
        {
            "sn":"3FE34ABE",
            "vrednosti":[
                [
                    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"
        }
    ],
    "uspešno": res,
    "sporočilo":nič
}

Primer

Kraj: vrne podatke o urnih ali dnevnih kWh za vsako vrsto porabe.

Pridobite urne/dnevne vrednosti kWh za proizvodnjo inverterja in izmenjavo omrežja (izvožene in uvožene)

URL&metoda

url：https://www.iammeter.com/api/v1/site/energyhistory/?Začetni čas={2024-05-05}&končni čas={2024-07-07}&groupby=&Žeton={2be6d1xxxxxxcc688}

Metoda: DOBITI

Omejitev：

groupby = dan :90 dni podatkov (90 kosov podatkov)

groupby = ura: 7-dnevni podatki (168 kosov podatkov)

Parametri

place_ID: Moja mesta->Uredi

Odziv: enofazni

place_id:1360

začetni čas=2024-05-05

končni čas=2024-05-07

po skupinah=dan

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

{
	"podatki": [{
			"čas": "2024/5/5 0:00:00",
			"dobitek": 0,
			"iz mreže": 9,62,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/6 0:00:00",
			"dobitek": 0,
			"iz mreže": 9.16,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		}
	],
	"uspešno": res,
	"sporočilo": nič
}

Odziv: trifazni

place_id:2393

začetni čas=2024-05-05

končni čas=2024-05-07

po skupinah=dan

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

{
	"podatki": [{
			"čas": "2024/5/5 0:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/6 0:00:00",
			"dobitek": 0,1,
			"iz mreže": 0,22,
			"toGrid": 7.15,
			"posebna obremenitev": 0,
			"samouporaba": 0
		}
	],
	"uspešno": res,
	"sporočilo": nič
}

place_id:2393

začetni čas=2024-05-05

končni čas=2024-05-06

groupby=ura

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

{
	"podatki": [{
			"čas": "2024/5/5 0:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 1:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 2:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 3:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 4:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 5:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 6:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 7:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 8:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 9:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 10:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 11:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 12:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 13:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 14:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 15:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 16:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 17:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 18:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 19:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 20:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 21:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 22:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		},
		{
			"čas": "2024/5/5 23:00:00",
			"dobitek": 0,
			"iz mreže": 0,
			"toGrid": 0,
			"posebna obremenitev": 0,
			"samouporaba": 0
		}
	],
	"uspešno": res,
	"sporočilo": nič
}

Referenca

API merilnika energije WiFi

Kakšne zmogljivosti ponuja IAMMETER?

Katera vrsta električnega števca najbolj ustreza vašim potrebam?

Kako najti merilnik moči glede na vaše zahteve

Uporabite 3-fazni števec električne energije tako, kot želite

3-fazni WiFi števec energije