IAMMETER-cloud proporciona algunes API, i el desenvolupador pot utilitzar aquestes API per fer feines interessants, com ara integrar les dades d'IAMMETER en algun sistema de tercers. Abans només havíem obert aquestes API als nostres socis comercials i a alguns grans clients, però ara hem decidit obrir-les a tots els nostres clients.
Benvinguts a fer-nos saber la vostra opinió al nostre fòrum. https://imeter.club
L'API no es pot visitar sense límit; limitarem el nombre de crides diàries de cada API. Si us plau, no crideu l'API amb massa freqüència.
Si el nombre de crides supera el límit horari o diari, l'API no retornarà res.
| Núm. | API | tipus de límit | horari | diari | descripció |
|---|---|---|---|---|---|
| 1 | /user/login | ip | 5 | 30 | una IP només pot cridar aquesta API 5 vegades per hora |
| 2 | /site/meterdata/ | SN | 12 | un SN només pot cridar aquesta API 12 vegades per hora | |
| 3 | /site/powerAnalysis | SN | 5 | un SN només pot cridar aquesta API 5 vegades al dia | |
| 4 | /site/offlineAnalysis | SN | 5 | un SN només pot cridar aquesta API 5 vegades al dia |
Retorna el token del compte. El token s'utilitzarà en gairebé totes les API.
No cal cridar aquesta API tret que vulgueu actualitzar el token. Si us plau, no crideu aquesta API més de 5 vegades en una hora, ni més de 30 vegades en un dia.
Obteniu el token del compte que s'utilitza en totes les API.
URL: https://www.iammeter.com/api/v1/user/login
Mètode: post
Aquesta API es pot provar en línia a IAMMETER SwaggerUI get token
| Núm. | paràmetre | observació | exemple |
|---|---|---|---|
| 1 | nom d'usuari | Nom d'usuari d'IAMMETER | test |
| 2 | contrasenya | contrasenya d'IAMMETER | 123456 |
El valor del token s'utilitzarà en totes les API següents.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
Aquest token també es pot llegir directament després d'iniciar sessió al sistema.
Obteniu les últimes dades penjades amb el SN corresponent.
Si us plau, no crideu aquesta API més de 12 vegades en una hora.
Bàsic (meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Aquesta API es pot provar en línia a IAMMETER SwaggerUI
Avançat (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Aquesta API es pot provar en línia a IAMMETER SwaggerUI meterdata i IAMMETER SwaggerUI meterdata2
Mètode: GET
Límit: si us plau, no sol·liciteu aquesta API més de 288 vegades al dia (interval de 5 minuts).
La diferència entre el bàsic i l'avançat:
Bàsic: sense PF (factor de potència)
Avançat: amb PF (factor de potència)
| Nom | Tipus | Exemple | |
|---|---|---|---|
| Token | String | xxx | obligatori |
| rtctime | string | 2025-6-16 | opcional |
definició de valors: tensió, corrent, potència activa, kWh importats, kWh exportats
{
"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
}
definició de valors: tensió, corrent, potència activa, factor de potència, kWh 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 així; tingueu en compte aquesta disposició
{
"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
}
Els tres arrays de values representen la fase A, la fase B i la fase C.
definició de valors: tensió, corrent, potència activa, kWh importats, kWh exportats
{
"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
}
Definició d'elements: tensió, corrent, potència activa, factor de potència, kWh importats, kWh exportats
{
"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
}
L'RTC (Rellotge de Temps Real) també és un paràmetre de la sol·licitud HTTP GET, 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 penjades més proper a la data especificada (2025-6-16), és a dir, el punt de temps registrat més proper.
Nota: aquestes API són les mateixes que les del capítol anterior, només s'hi afegeixen alguns paràmetres més
Retorna les dades històriques en l'interval i el rang de temps configurats.
Les dades instantànies tenen un interval d'1 minut. Hi ha 60*24=1440 elements de dades per dia. Si sol·liciteu les dades històriques amb un interval d'1 minut, només podeu sol·licitar les dades d'1.39(2000/1440) dies. Però si sol·liciteu les dades amb un interval de 5 minuts, podeu sol·licitar les dades de gairebé 7 dies.
Bàsic (meterdatalist): https://www.iammeter.com/api/v1/site/meterdatalist/{sn}
Avançat (meterdatalist2): https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
La diferència entre el bàsic i l'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 a IAMMETER SwaggerUI meterdata i IAMMETER SwaggerUI meterdata2
| Nom | Tipus | Exemple | |
|---|---|---|---|
| Token | String | xxx | obligatori |
| interval | number | 300 | obligatori, unitat: segon |
| startTime | string | 2023-09-01 | obligatori |
| endTime | string | 2023-09-07 | obligatori |
Dades: [tensió, corrent, potència, energia importada, energia exportada, hora UTC, hora local]
{
"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
}
{
"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
}
{
"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
}
Retorna el resultat de l'anàlisi de potència en el temps especificat.
Si us plau, no crideu aquesta API més de 5 vegades en un dia.
URL: https://www.iammeter.com/api/v1/site/powerAnalysis
Mètode: get
Límit: si us plau, no sol·liciteu aquesta API per SN més de 5 vegades al dia.
| Nom | Tipus | Exemple | |
|---|---|---|---|
sn |
String | xxx | obligatori |
startTime |
String | 2023-09-01 | opcional |
endTime |
String | 2023-09-07 | opcional |
Nota:
average: lectura mitjana de potència durant aquest rang de temps.
averageDaytime: lectura mitjana de potència durant el dia (8:00-20:00) en aquest rang de temps.
minimum: lectura mínima de potència durant aquest rang de temps.
maximum: lectura màxima de potència durant aquest rang de temps.
{
"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
}
Retorna el resultat de l'anàlisi de potència dels últims 7 dies.
Retorna el resultat de l'anàlisi de potència del dia especificat
Retorna l'estat de desconnexió del SN corresponent en el temps especificat.
Si us plau, no crideu aquesta API més de 5 vegades en un dia.
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
Mètode：Get
Límit: si us plau, no sol·liciteu aquesta API per SN més de 5 vegades al dia.
| Nom | Tipus | Exemple | |
|---|---|---|---|
sn |
String | xxxx | obligatori |
startTime |
String | 2023-09-01 | opcional |
endTime |
String | 2023-09-07 | opcional |
interval (unitat: minut) |
Número | 5 | opcional |
Nota:
En aquest rang de temps hi ha un total de 10080 minuts.
El temps total de desconnexió en aquest rang de temps és de 906 minuts.
Els intervals de desconnexió superiors a 5 minuts es llisten a la matriu.
{
"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
}
Retorna el resultat de l'anàlisi de desconnexions del dia especificat
Retorna l'últim valor de tots els comptadors d'energia d'aquest compte.
URL：https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Mètode：Get
Límit: assegureu-vos de no fer sol·licituds a aquesta API més sovint que una vegada cada 5 minuts.
| Nom | Tipus | Exemple | |
|---|---|---|---|
| Token | String | xxx | obligatori |
{
"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
}
Recupereu els valors kWh horaris/diaris per a la generació de l'inversor i l'intercanvi amb la xarxa (tant exportat com importat)
URL：https://www.iammeter.com/api/v1/site/energyhistory/?startTime={2024-05-05}&endTime={2024-07-07}&groupby=&Token={2be6d1xxxxxxcc688}
Mètode: get
Límit：
groupby = day :dades de 90 dies (90 elements de dades)
groupby = hour :dades de 7 dies (168 elements de dades)
| Nom | Tipus | Descripció | Exemple | |
|---|---|---|---|---|
| Token | String | token del compte | xxx | obligatori |
| place_ID | number | ID del lloc | obligatori | |
| startTime | string | hora d'inici del retorn d'aquesta API | 2023-09-01 | obligatori |
| endTime | string | hora de finalització del retorn d'aquesta API | 2023-09-07 | obligatori |
| groupby | enum | seleccioneu l'interval de dades retornat (hora/dia) | day/hour | obligatori |
place_ID: Els meus llocs->Edita
place_id:1360
startTime=2024-05-05
endTime=2024-05-07
groupby=day
{
"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
}
place_id:2393
startTime=2024-05-05
endTime=2024-05-07
groupby=day
{
"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
{
"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
}
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 comptador de potència adequat als vostres requisits
Utilitzeu el comptador d'energia trifàsic de la manera que preferiu
Comptador d'energia Wi-Fi trifàsic (WEM3080T)
Comptador d'energia Wi-Fi monofàsic (WEM3080)
Comptador d'energia Wi-Fi trifàsic (WEM3046T)
Comptador d'energia Wi-Fi trifàsic (WEM3050T)