Com utilitzar IAMMETER-cloud de manera més eficient per l'API

Premissa

IAMMETER-cloud proporciona algunes API i el desenvolupador pot utilitzar aquestes API per fer alguna feina interessant, com ara integrar les dades d'IAMMETER a algun sistema de tercers. Abans acabàvem d'obrir aquestes API als nostres socis comercials i a alguns grans clients, però ara hem decidit obrir-les a tots els nostres clients.

Benvingut a fer-nos saber el vostre pensament al nostre fòrum.https://imeter.club

Límit de l'API

L'API no es pot visitar il·limitadament, limitarem el nombre de trucades diàries per a cada API. No truqueu a l'API amb més freqüència.

Si el recompte de trucades supera la limitació horària o diària, l'API no retornarà res.

Compte: obteniu el testimoni del compte

Torna el testimoni del compte. El testimoni s'utilitzarà en gairebé totes les API.

No cal que truqueu a aquesta API tret que vulgueu actualitzar el testimoni.No truqueu a aquesta API més de 5 vegades en una hora i no més de 30 vegades en un dia.

URL i mètode

Obteniu el testimoni del compte que s'utilitza a totes les API.

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

Mètode:publicació

Aquesta API es pot provar en línia aIAMMETER SwaggerUI obté el testimoni

Dades

Resposta

El valor del testimoni s'utilitzarà a totes les API següents.

{
    "dades": {
        "id": 2025,
        "token": "349dfxxxxxxac5169",
        "refreshToken": "8adf75e5da10424985f3b83855133982"
    },
    "èxit": cert,
    "missatge": nul
}

Obteniu el testimoni del sistema web directament

Aquest testimoni també es pot llegir directament després d'iniciar sessió al sistema.

Contador d'energia: obteniu les últimes dades de càrrega i l'hora UTC

Obteniu les darreres dades de càrrega amb el SN considerat.

No truqueu a aquesta API més de 12 vegades en una hora.

URL i mètode

Bàsic (dades de mesura): https://www.iammeter.com/api/v1/site/meterdata/{sn}

Aquesta API es pot provar en línia aAMPERÍMETRE SwaggerUI

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

Aquesta API es pot provar en línia aIAMMETER SwaggerUI dades de mesuraiAMPERÍMETRE SwaggerUI meterdata2

Mètode: ACONSEGUIR

Límit: no sol·liciteu aquesta API més de 288 vegades al dia (interval de 5 minuts).

Diferència entre bàsic i avançat:

Bàsic: sense PF (factor de potència)

Avançat: amb PF (factor de potència)

Paràmetres

Resposta: dades de mesura monofàsica (sense factor de potència)

definició de valors: tensió, corrent, potència activa, Kwh importats, Kwh exportats

{
"dades": {
"valors": [
[
230.220, //tensió
1.300, //corrent
119.000, //potència activa
1766.590, //kWh importats
0.000 //kWh exportats
]
],
"horalocal": "28/8/2020 15:27:33",
"horagmt": "28/8/2020 5:27:33"
},
"correcte": cert,
"missatge": nul
}

Resposta: monofàsica -meterdata2 (amb factor de potència)

definició de valors: tensió, corrent, potència activa,factor de potènciakWh importats, kWh exportats.

Tot i que reconeixem que col·locar el factor de potència entre la potència activa i l'energia importada no és òptim, el format actual ja està configurat d'aquesta manera; tingueu en compte aquesta disposició.

{
"dades":{
"valors":[
[
233.41, //tensió
0.718, //corrent
111, //potència activa
0.66, //factor de potència
5724.85, //energia importada
0 //energia exportada
]
],
"hora local": "2023/11/21 14:30:22",
"hora gmt": "2023/11/21 6:30:22"
},
"correcte":cert,
"missatge":nul
}

Resposta: dades de mesura trifàsiques (sense factor de potència)

Les tres matrius avalorsrepresenten la fase A, la fase B i la fase C.

definició de valors: tensió, corrent, potència activa, Kwh importats, Kwh exportats

{
"dades": {
"valors": [
[
242.600,//tensió
1.000,//corrent
216.000,//potència activa
32354.600,//energia importada
0.000//energia exportada
],
[
242.600,
1.000,
1986.000,
30536.410,
17704.720
],
[
0.000,
0.000,
0.000,
0.000,
0.000
]
],
"horalocal": "2020/8/28 15:30:48",
"horagmt": "28/8/2020 5:30:48"
},
"correcte": cert,
"missatge": nul
}

Resposta: 3 phase -meterdata2 (amb factor de potència)

Definició d'elements: tensió, corrent, potència activa,factor de potència,Kwh importats, Kwh exportats

{
    "dades":{
        "valors":[
            [//fase A
                233,8,//tensió
                0,03,//actual
                4,//potència activa
                0,57,//factor de potència
                222,53,//Kwh importats
                0 //Kwh exportats
            ],
            [//fase B
                5,
                0,
                0,
                0,
                0,
                0
            ],
            [ //fase C
                3.1,
                0,
                0,
                0,
                0,
                0
            ]
        ],
        "localTime":"2023/11/21 14:39:36",
        "gmtTime":"2023/11/21 6:39:36"
    },
    "èxit":cert,
    "missatge":null
}

Exemple (obté el valor de càrrega més recent)

Exemple (obté el valor a prop del temps RTC específic)

El RTC (Real-Time Clock) també és un paràmetre a la sol·licitud HTTP GET, tal com es mostra a continuació:

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

Aquesta sol·licitud retornarà el valor de les dades del comptador carregades més proper a la data especificada (16-6-2025), és a dir, el punt de temps registrat més proper.

Contador d'energia: obteniu el registre de l'historial

Nota: aquestes API són les mateixes que les del capítol anterior, només que s'hi afegeixen alguns paràmetres més.

Retorna les dades històriques de l'interval i l'interval de temps establerts.

• interval de temps: darrer mes
• longitud màxima de dades: 2000 peces

Les dades instantànies estan en un interval d'1 min. Hi ha 60*24=1440 dades per dia. Si sol·liciteu les dades històriques en un interval d'1 min, només podeu sol·licitar les dades d'1,39 (2000/1440) dies. Però si sol·liciteu les dades en un interval de 5 minuts, podeu sol·licitar les dades de gairebé 7 dies.

URL i mètode

Bàsic (llista de dades de mesura):https://www.iammeter.com/api/v1/site/meterdatalist/

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

Diferència entre bàsic i avançat:

Bàsic: sense PF (factor de potència)

Avançat: amb PF (factor de potència)

Aquesta API es pot provar en línia aIAMMETER SwaggerUI dades de mesuraiAMPERÍMETRE SwaggerUI meterdata2

Paràmetres

Resposta: monofàsica - meterdatalist

Dades: [tensió, corrent, potència, importació d'energia, exportació d'energia, hora utc, hora local]

{
    "dades": [
        [
            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",
            "11/9/2023 14:01:33"
        ]
    ],
    "èxit": cert,
    "missatge": nul
}

Resposta: trifàsic - meterdatalist

{
    "dades": [
        [
            230,//tensió faseA
            0,//actual
            0,//potència activa
            468,41,//kWh importats
            0,//kWh exportat
            230,//Fase B
            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",
            "11/9/2023 16:02:08"
        ]
    ],
    "èxit": cert,
    "missatge": nul
}

Resposta: trifàsica - meterdatalist2

{
    "dades":[
        {//primeres dades
            "rtcTime":"2023/9/1 0:00:22",
            "gmtTime":"2023/8/31 16:00:22",
            "valors":[
                [ //fase A
                    235,2,//tensió
                    0,03,//actual
                    4,//potència activa
                    0,57,//factor de potència
                    210,21,//import Kwh
                    0 //Kwh exportats
                ],
                [//fase B
                    5.5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [ //fase C
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        {//segons dades
            "rtcTime":"2023/9/1 8:00:49",
            "gmtTime":"2023/9/1 0:00:49",
            "valors":[
                [
                    233,4,
                    0,03,
                    4,
                    0,57,
                    210.24,
                    0
                ],
                [
                    5.4,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        {//tercera dada
            "rtcTime":"2023/9/1 16:00:24",
            "gmtTime":"2023/9/1 8:00:24",
            "valors":[
                [
                    235,6,
                    0,03,
                    4,
                    0,57,
                    210.27,
                    0
                ],
                [
                    5.5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [
                    3.4,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        }
    ],
    "èxit":cert,
    "missatge":null
}

Exemple

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

Contador d'energia: anàlisi de la lectura de potència

Retorna el resultat de l'anàlisi de potència en el temps especificat.

No truqueu a aquesta API més de 5 vegades en un dia.

URL i mètode

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

Mètode: ACONSEGUIR

Límit: no sol·liciteu aquesta API per SN més de 5 vegades al dia.

Paràmetres

Nota:

1. L'interval de temps màxim és de 7 dies l'últim mes.
2. El paràmetre de temps és opcional, si no feu servir el paràmetre, l'API retornarà el resultat dels darrers 7 dies.

Resposta

mitjana: lectura de potència mitjana durant aquest interval de temps.

averageDaytime: lectura de potència mitjana diürna (8:00 a.m.-8:00 p.m.) durant aquest interval de temps.

mínim: lectura de potència mínima durant aquest interval de temps.

màxim: lectura de potència màxima durant aquest interval de temps.

{
    "dades": {
        "startTime": "2023-09-01",
        "endTime": "2023-09-07",
        "mitjana": 862,6,
        "mitjana de dia": 836,9,
        "mínim": 259,0,
        "màxim": 3999,0
    },
    "èxit": cert,
    "missatge": nul
}

Exemple

Retorna el resultat de l'anàlisi de potència dels darrers 7 dies.

Retorna el resultat de l'anàlisi de potència del dia especificat

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

Contador d'energia: anàlisi d'estat fora de línia

Retorna l'estat de desconnexió amb el SN considerat en el temps especificat.

No truqueu a aquesta API més de 5 vegades en un dia.

URL i mètode

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

Mètode：Aconseguir

Límit: no sol·liciteu aquesta API per SN més de 5 vegades al dia.

Paràmetres

Nota:

1. L'interval de temps màxim és de 7 dies l'últim mes.
2. El paràmetre de temps és opcional, si no feu servir el paràmetre, l'API retornarà el resultat dels darrers 7 dies.
3. Si no especifiqueu l'interval, el valor predeterminat és de 5 minuts.

Resposta

Hi ha un total de 10080 minuts en aquest interval de temps.

El temps total fora de línia és de 906 minuts en aquest interval de temps.

L'espai fora de línia que és superior a 5 minuts es mostra a la matriu.

{
    "dades": {
        "startTime": "2023-09-05",
        "endTime": "2023-09-11",
        "Recompte fora de línia": 906,
        "Recompte total": 10080,
        "llista": [
            {
                "startTime": "2023/9/5 0:00:00",
                "endTime": "2023/9/5 15:06:14",
                "durada": 906
            }
        ]
    },
    "èxit": cert,
    "missatge": nul
}

Exemple

Retorna el resultat de l'anàlisi fora de línia del dia especificat

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

Compte: recupera les dades més recents de tots els comptadors d'energia dins d'un sol compte

Retorna el valor més recent de tot el comptador d'energia d'aquest compte.

URL i mètode

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

Mètode：Aconseguir

Límit: Assegureu-vos que no feu sol·licituds a aquesta API amb més freqüència que una vegada cada 5 minuts.

Paràmetres

Resposta

{
    "dades":[
        {
            "sn":"DA2BED94",
            "valors":[
                223,71,
                1,74,
                225,
                14761.03,
                0
            ],
            "gmtTime":"2024/2/22 3:46:20"
        },
        {
            "sn":"B384789C",
            "valors":[
                [
                    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",
            "valors":[
                [
                    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",
            "valors":[
                [
                    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",
            "valors":[
                [
                    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,
                    03/03/1946
                    0,
                    49,99,
                    0,94
                ]
            ],
            "gmtTime":"2024/2/22 3:46:01"
        }
    ],
    "èxit":cert,
    "missatge":null
}

Exemple

Lloc: retorna les dades horàries o diàries de kWh per a cada tipus d'ús.

Recuperar els valors de kWh horari/diari per a la generació d'inversors i l'intercanvi de xarxa (tant exportats com importats)

URL i mètode

url：https://www.iammeter.com/api/v1/site/energyhistory/?l'hora d'inici={2024-05-05}&fi del temps={2024-07-07}&agrupar per=&Token={2be6d1xxxxxxcc688}

Mètode: ACONSEGUIR

Límit：

groupby = dia: dades de 90 dies (dades de 90 unitats)

groupby = hora: dades de 7 dies (dades de 168 peces)

Paràmetres

lloc_ID: Els meus llocs->Edita

Resposta: fase única

lloc_id:1360

startTime=2024-05-05

endTime=2024-05-07

groupby=dia

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

{
	"dades": [{
			"hora": "2024/5/5 0:00:00",
			"rendiment": 0,
			"fromGrid": 9,62,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/6 0:00:00",
			"rendiment": 0,
			"fromGrid": 9.16,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		}
	],
	"èxit": cert,
	"missatge": nul
}

Resposta: tres fases

lloc_id:2393

startTime=2024-05-05

endTime=2024-05-07

groupby=dia

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

{
	"dades": [{
			"hora": "2024/5/5 0:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/6 0:00:00",
			"rendiment": 0,1,
			"fromGrid": 0,22,
			"toGrid": 7,15,
			"Càrrega especial": 0,
			"Ús propi": 0
		}
	],
	"èxit": cert,
	"missatge": nul
}

lloc_id:2393

startTime=2024-05-05

endTime=2024-05-06

groupby=hora

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

{
	"dades": [{
			"hora": "2024/5/5 0:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 1:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 2:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 3:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 4:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 5:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 6:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 7:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 8:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 9:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 10:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 11:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 12:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 13:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 14:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 15:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 16:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 17:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 18:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 19:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 20:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 21:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 22:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		},
		{
			"hora": "2024/5/5 23:00:00",
			"rendiment": 0,
			"fromGrid": 0,
			"toGrid": 0,
			"Càrrega especial": 0,
			"Ús propi": 0
		}
	],
	"èxit": cert,
	"missatge": nul
}

Referència

API del comptador d'energia WiFi

Quines capacitats ofereix IAMMETER?

Quin tipus de comptador elèctric s'adapta millor a les vostres necessitats?

Com trobar el mesurador de potència segons els vostres requisits

Utilitzeu el comptador d'energia trifàsic de la manera que preferiu

Comptador d'energia WiFi trifàsic