IAMMETER-cloud fornisce alcune API e gli sviluppatori possono utilizzarle per realizzare lavori interessanti, come integrare i dati di IAMMETER in sistemi di terze parti. In passato abbiamo aperto queste API solo ai nostri partner commerciali e ad alcuni grandi clienti, ma ora abbiamo deciso di aprirle a tutti i nostri clienti.
Vi invitiamo a condividere le vostre opinioni sul nostro forum. https://imeter.club
Le API non possono essere utilizzate senza limiti; limiteremo il numero di chiamate giornaliere per ciascuna API. Si prega di non chiamare l'API con troppa frequenza.
Se il numero di chiamate supera il limite orario o giornaliero, l'API non restituirà nulla.
| No. | API | tipo limite | orario | Giornaliero | descrizione |
|---|---|---|---|---|---|
| 1 | /user/login | ip | 5 | 30 | un IP può chiamare questa API solo 5 volte all'ora |
| 2 | /site/meterdata/ | SN | 12 | un SN può chiamare questa API solo 12 volte all'ora | |
| 3 | /site/powerAnalysis | SN | 5 | un SN può chiamare questa API solo 5 volte al giorno | |
| 4 | /site/offlineAnalysis | SN | 5 | un SN può chiamare questa API solo 5 volte al giorno |
Restituisce il token dell'account. Il token verrà utilizzato in quasi tutte le API.
Non è necessario chiamare questa API a meno che non si desideri aggiornare il token. Si prega di non chiamare questa API più di 5 volte in un'ora e non più di 30 volte in un giorno.
Ottieni il token dell'account utilizzato in tutte le API.
URL: https://www.iammeter.com/api/v1/user/login
Metodo: post
Questa API può essere testata online in IAMMETER SwaggerUI get token
| No. | parametro | osservazione | esempio |
|---|---|---|---|
| 1 | user name | Nome utente IAMMETER | test |
| 2 | password | password di IAMMETER | 123456 |
Il valore del token verrà utilizzato in tutte le API seguenti.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
Questo token può anche essere letto direttamente dopo aver effettuato l'accesso al sistema.
Ottiene gli ultimi dati caricati relativi al SN specificato.
Si prega di non chiamare questa API più di 12 volte in un'ora.
Base (meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Questa API può essere testata online in IAMMETER SwaggerUI
Avanzata (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Questa API può essere testata online in IAMMETER SwaggerUI meterdata e in IAMMETER SwaggerUI meterdata2
Metodo: GET
Limite: si prega di non richiedere questa API più di 288 volte al giorno (intervallo di 5 minuti).
Differenza tra base e avanzata:
Base: senza PF (Power factor)
Avanzata: con PF (Power factor)
| Nome | Tipo | Esempio | |
|---|---|---|---|
| Token | String | xxx | richiesto |
| rtctime | string | 2025-6-16 | opzionale |
definizione dei valori: tensione, corrente, potenza attiva, kWh importati, kWh esportati
{
"data": {
"values": [
[
230.220, //tensione
1.300, //corrente
119.000,//potenza attiva
1766.590, //kWh importati
0.000 //kWh esportati
]
],
"localTime": "2020/8/28 15:27:33",
"gmtTime": "2020/8/28 5:27:33"
},
"successful": true,
"message": null
}
definizione dei valori: tensione, corrente, potenza attiva, power factor, kWh importati, kWh esportati.
Pur riconoscendo che posizionare il power factor tra la potenza attiva e l'energia importata non sia ottimale, il formato corrente è già impostato in questo modo — si prega di tenere presente questa disposizione.
{
"data":{
"values":[
[
233.41, //tensione
0.718,//corrente
111,//potenza attiva
0.66,//power factor
5724.85, //energia importata
0 //energia esportata
]
],
"localTime":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"successful":true,
"message":null
}
I tre array in values rappresentano la Fase A, la Fase B e la Fase C.
definizione dei valori: tensione, corrente, potenza attiva, kWh importati, kWh esportati
{
"data": {
"values": [
[
242.600,//tensione
1.000,//corrente
216.000,//potenza attiva
32354.600,//energia importata
0.000//energia esportata
],
[
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
}
Definizione degli elementi: tensione, corrente, potenza attiva, power factor, kWh importati, kWh esportati
{
"data":{
"values":[
[//fase A
233.8,//tensione
0.03,//corrente
4,//potenza attiva
0.57,//power factor
222.53,//kWh importati
0 //kWh esportati
],
[//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"
},
"successful":true,
"message":null
}
L'RTC (Real-Time Clock) è anche un parametro nella richiesta HTTP GET, come mostrato di seguito:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
Questa richiesta restituirà il valore dei dati del contatore più vicino alla data specificata (2025-6-16), ovvero il punto temporale registrato più prossimo.
Nota: queste API sono le stesse del capitolo precedente, con solo alcuni parametri aggiuntivi.
Restituisce i dati storici nell'intervallo di tempo e nell'intervallo impostato.
I dati istantanei sono a intervallo di 1 minuto. Ci sono 60*24=1440 elementi di dati al giorno. Se richiedete i dati storici con intervallo di 1 minuto, potete richiedere solo i dati di 1,39 (2000/1440) giorni. Ma se richiedete i dati con intervallo di 5 minuti, potete richiedere i dati di quasi 7 giorni.
Base (meterdatalist): https://www.iammeter.com/api/v1/site/meterdatalist/{sn}
Avanzata (meterdatalist2): https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Differenza tra base e avanzata:
Base: senza PF (Power factor)
Avanzata: con PF (Power factor)
Questa API può essere testata online in IAMMETER SwaggerUI meterdata e in IAMMETER SwaggerUI meterdata2
| Nome | Tipo | Esempio | |
|---|---|---|---|
| Token | String | xxx | richiesto |
| interval | number | 300 | richiesto, unità: secondo |
| startTime | string | 2023-09-01 | richiesto |
| endTime | string | 2023-09-07 | richiesto |
Dati: [tensione, corrente, potenza, energia importata, energia esportata, orario utc, orario locale]
{
"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,//tensione faseA
0,//corrente
0,//potenza attiva
468.41,//kWh importati
0,//kWh esportati
230,//FaseB
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",
"2023/9/11 16:02:08"
]
],
"successful": true,
"message": null
}
{
"data":[
{ //primo dato
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"values":[
[ //fase A
235.2,//tensione
0.03,//corrente
4,//potenza attiva
0.57,//power factor
210.21,//kWh importati
0 //kWh esportati
],
[//fase B
5.5,
0,
0,
0,
0,
0
],
[ //fase C
3.3,
0,
0,
0,
0,
0
]
]
},
{ //secondo dato
"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
]
]
},
{ //terzo dato
"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
}
Restituisce il risultato dell'analisi della potenza nel periodo specificato.
Si prega di non chiamare questa API più di 5 volte al giorno.
URL: https://www.iammeter.com/api/v1/site/powerAnalysis
Metodo: get
Limite: si prega di non richiedere questa API per SN più di 5 volte al giorno.
| Nome | Tipo | Esempio | |
|---|---|---|---|
sn |
String | xxx | richiesto |
startTime |
String | 2023-09-01 | opzionale |
endTime |
String | 2023-09-07 | opzionale |
Nota:
average: lettura media della potenza in questo intervallo di tempo.
averageDaytime: lettura media della potenza nelle ore diurne (8:00-20:00) in questo intervallo di tempo.
minimum: lettura minima della potenza in questo intervallo di tempo.
maximum: lettura massima della potenza in questo intervallo di tempo.
{
"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
}
Restituisce il risultato dell'analisi della potenza degli ultimi 7 giorni.
Restituisce il risultato dell'analisi della potenza del giorno specificato
Restituisce lo stato di disconnessione relativo al SN specificato nel periodo indicato.
Si prega di non chiamare questa API più di 5 volte al giorno.
URL: https://www.iammeter.com/api/v1/site/offlineAnalysis
Metodo: Get
Limite: si prega di non richiedere questa API per SN più di 5 volte al giorno.
| Nome | Tipo | Esempio | |
|---|---|---|---|
sn |
String | xxxx | richiesto |
startTime |
String | 2023-09-01 | opzionale |
endTime |
String | 2023-09-07 | opzionale |
interval(unità : minuti) |
Number | 5 | opzionale |
Nota:
Ci sono 10080 minuti totali in questo intervallo di tempo.
Il tempo offline totale è di 906 minuti in questo intervallo di tempo.
L'intervallo offline superiore a 5 minuti è elencato nell'array.
{
"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
}
Restituisce il risultato dell'analisi offline del giorno specificato
Restituisce l'ultimo valore di tutti i contatori energetici in questo account.
URL: https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Metodo: Get
Limite: si prega di non effettuare richieste a questa API più frequentemente di una volta ogni 5 minuti.
| Nome | Tipo | Esempio | |
|---|---|---|---|
| Token | String | xxx | richiesto |
{
"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
}
Recupera i valori kWh orari/giornalieri per la generazione dell'inverter e lo scambio con la rete (sia esportati che importati).
Metodo: get
Limite:
groupby = day: 90 giorni di dati (90 dati)
groupby = hour: 7 giorni di dati (168 dati)
| Nome | Tipo | Descrizione | Esempio | |
|---|---|---|---|---|
| Token | String | token dell'account | xxx | richiesto |
| place_ID | number | ID del luogo | richiesto | |
| startTime | string | ora di inizio restituita da questa API | 2023-09-01 | richiesto |
| endTime | string | ora di fine restituita da questa API | 2023-09-07 | richiesto |
| groupby | enum | seleziona intervallo dati restituito (ora/giorno) | day/hour | richiesto |
place_ID: I Miei Luoghi -> Modifica
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 contatore energetico WiFi
Quali funzionalità offre IAMMETER?
Quale tipo di contatore elettrico si adatta meglio alle tue esigenze?
Come trovare il contatore di energia adatto alle tue esigenze
Utilizza il contatore energetico trifase nel modo che preferisci
Contatore di energia Wi-Fi trifase (WEM3080T)
Contatore di energia Wi-Fi monofase (WEM3080)
Contatore di energia Wi-Fi trifase (WEM3046T)
Contatore di energia Wi-Fi trifase (WEM3050T)