IAMMETER-cloud fornisce alcune API e lo sviluppatore può utilizzare queste API per svolgere lavori interessanti, come l'integrazione dei dati di IAMMETER in alcuni sistemi di terze parti. In precedenza abbiamo aperto queste API ai nostri partner commerciali e ad alcuni grandi clienti, ma ora abbiamo deciso di aprirle a tutti i nostri clienti.
Benvenuto per farci sapere il tuo pensiero sul nostro forum.https://imeter.club
L'API non può essere visitata illimitatamente, limiteremo il conteggio delle chiamate giornaliere per ciascuna API. Si prega di non chiamare l'API più frequentemente.
Se il conteggio delle chiamate supera il limite orario o giornaliero, l'API non restituirà nulla.
| No. | API | tipo limite | ogni ora | Quotidiano | descrizione |
|---|---|---|---|---|---|
| 1 | /Login utente | ip | 5 | 30 | un IP può chiamare questa API solo 5 volte all'ora |
| 2 | /sito/daticontatori/ | 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/offlineAnalisi | SN | 5 | un SN può chiamare questa API solo 5 volte al giorno |
Restituisci il token dell'account. Il token verrà utilizzato in quasi tutte le API.
Non è necessario chiamare questa API a meno che non desideri aggiornare il token.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:inviare
| No. | parametro | osservazione | esempio |
|---|---|---|---|
| 1 | nome utente | Nome utente di IAMMETER | test |
| 2 | parola d'ordine | password di IAMMETRO | 123456 |
Il valore del token verrà utilizzato in tutte le API seguenti.
{
"dati": {
"id": 2025,
"gettone": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"di successo": vero,
"messaggio": null
}Questo token può anche essere letto direttamente dopo aver effettuato l'accesso al sistema.
Ottieni gli ultimi dati di caricamento con il SN considerato.
Non chiamare questa API più di 12 volte in un'ora.
Base(dati contatore): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Avanzate(daticontatori2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Metodo: OTTENERE
Limite: non richiedere questa API più di 288 volte al giorno (intervallo di 5 minuti).
La differenza tra base e avanzato:
Di base: senza PF (fattore di potenza)
Avanzato: con PF (fattore di potenza)
| Nome | Tipo | Esempio | |
|---|---|---|---|
| Gettone | Corda | xxx | necessario |
definizione valori: tensione, corrente, potenza attiva, Kwh importati, Kwh esportati
{
"dati": {
"valori": [
[
230.220,
1.300,
119.000,
1766.590,
0.000
]
],
"localTime": "2020/8/28 15:27:33",
"gmtTime": "2020/8/28 5:27:33"
},
"di successo": vero,
"messaggio": null
}definizione dei valori: tensione, corrente, potenza attiva,fattore di potenza,Kwh importati, Kwh esportati
{
"dati":{
"valori":[
[
233.41,
0,718,
111,
0,66,
5724.85,
0
]
],
"localTime": "2023/11/21 14:30:22",
"gmtTime": "2023/11/21 6:30:22"
},
"riuscito": vero,
"messaggio": null
}I tre array invalorirappresentano la Fase A, la Fase B e la Fase C.
Definizione dell'elemento: tensione, corrente, potenza attiva,fattore di potenza,Kwh importati, Kwh esportati
{
"dati": {
"valori": [
[
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
]
],
"localTime": "2020/8/28 15:30:48",
"gmtTime": "2020/8/28 5:30:48"
},
"di successo": vero,
"messaggio": null
}{
"dati":{
"valori":[
[//fase A
233,8,//tensione
0,03,//corrente
4,//potenza attiva
0,57,//fattore di potenza
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"
},
"riuscito": vero,
"messaggio": null
}
Restituisce i dati storici sull'intervallo e l'intervallo di tempo impostati.
I dati istantanei sono in intervalli di 1 minuto. Ci sono 60*24=1440 dati al giorno. Se richiedi i dati storici nell'intervallo di 1 minuto, puoi richiedere solo i dati di 1,39 (2000/1440) giorni. Ma se richiedi i dati con un intervallo di 5 minuti, puoi richiedere i dati di quasi 7 giorni.
Base(elencodaticontatori):https://www.iammeter.com/api/v1/site/meterdatalist/
**Avanzate(elencodaticontatori2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
La differenza tra base e avanzato:
Di base: senza PF (fattore di potenza)
Avanzato: con PF (fattore di potenza)
| Nome | Tipo | Esempio | |
|---|---|---|---|
| Gettone | Corda | xxx | necessario |
| intervallo | numero | 300 | richiesto, unità: secondo |
| Ora di inizio | corda | 2023-09-01 | necessario |
| Tempo scaduto | corda | 2023-09-07 | necessario |
Dati: [tensione, corrente, potenza, energia importata, energia esportata, ora UTC, ora locale]
{
"dati": [
[
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"
]
],
"di successo": vero,
"messaggio": null
}{
"dati": [
[
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"
]
],
"di successo": vero,
"messaggio": null
}{
"dati":[
{ //primi dati
"rtcTime": "2023/9/1 0:00:22",
"gmtTime": "2023/8/31 16:00:22",
"valori":[
[ //fase A
235,2,//tensione
0,03,//corrente
4,//potenza attiva
0,57,//fattore di potenza
210,21,//importazione Kwh
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",
"valori":[
[
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",
"valori":[
[
235,6,
0,03,
4,
0,57,
210.27,
0
],
[
5,5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
"riuscito": vero,
"messaggio": null
}
Restituisce il risultato dell'analisi energetica nel tempo specificato.
Si prega di non chiamare questa API più di 5 volte in un giorno.
URL: https://www.iammeter.com/api/v1/site/powerAnalysis
Metodo: Ottenere
Limite: non richiedere questa API per SN più di 5 volte al giorno.
| Nome | Tipo | Esempio | |
|---|---|---|---|
sn |
Corda | xxx | necessario |
Ora di inizio |
Corda | 2023-09-01 | opzionale |
Tempo scaduto |
Corda | 2023-09-07 | opzionale |
Nota:
media: lettura della potenza media durante questo intervallo di tempo.
AverageDaytime: lettura della potenza media durante il giorno (8:00-20:00) durante questo intervallo di tempo.
minimo: lettura della potenza minima durante questo intervallo di tempo.
massimo: lettura della potenza massima durante questo intervallo di tempo.
{
"dati": {
"startTime": "2023-09-01",
"Orafine": "07-09-2023",
"media": 862,6,
"mediaDaytime": 836,9,
"minimo": 259,0,
"massimo": 3999,0
},
"di successo": vero,
"messaggio": null
}Restituisce il risultato dell'analisi energetica degli ultimi 7 giorni.
Restituisce il risultato dell'analisi energetica del giorno specificato
Restituisce lo stato di disconnessione con il SN considerato nel tempo specificato.
Si prega di non chiamare questa API più di 5 volte in un giorno.
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
Metodo：Ottenere
Limite: non richiedere questa API per SN più di 5 volte al giorno.
| Nome | Tipo | Esempio | |
|---|---|---|---|
sn |
Corda | xxxx | necessario |
Ora di inizio |
Corda | 2023-09-01 | opzionale |
Tempo scaduto |
Corda | 2023-09-07 | opzionale |
intervallo(unità:minuto) |
Numero | 5 | opzionale |
Nota:
Ci sono un totale di 10080 minuti in questo intervallo di tempo.
Il tempo offline totale è di 906 minuti in questo intervallo di tempo.
L'intervallo offline maggiore di 5 minuti viene elencato nell'array.
{
"dati": {
"startTime": "2023-09-05",
"Orafine": "2023-09-11",
"offlineCount": 906,
"totalCount": 10080,
"lista": [
{
"startTime": "2023/9/5 0:00:00",
"Orafine": "5/9/2023 15:06:14",
"durata": 906
}
]
},
"di successo": vero,
"messaggio": null
}Restituisce il risultato dell'analisi offline del giorno specificato
Restituisce l'ultimo valore di tutti i contatori di energia in questo account.
URL：https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Metodo：Ottenere
Limite: assicurati di non effettuare richieste a questa API più frequentemente di una volta ogni 5 minuti.
| Nome | Tipo | Esempio | |
|---|---|---|---|
| Gettone | Corda | xxx | necessario |
{
"dati":[
{
"sn": "DA2BED94",
"valori":[
223,71,
1,74,
225,
14761.03,
0
],
"gmtTime": "2024/2/22 3:46:20"
},
{
"sn": "B384789C",
"valori":[
[
248,9,
13.9,
3356,
21228,
0,
nullo,
nullo
],
[
248,9,
13.9,
-2747,
8988.48,
18489.44,
nullo,
nullo
],
[
nullo,
nullo,
nullo,
nullo,
nullo,
nullo,
nullo
],
[
248,9,
13.9,
-2747,
8988.48,
18489.44,
nullo,
nullo
]
],
"gmtTime": "2024/2/22 3:45:15"
},
{
"sn": "674B1E5D",
"valori":[
[
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",
"valori":[
[
245.3,
6,5,
1604,
46055.7,
0,
nullo,
nullo
],
[
245.3,
6,5,
-910,
15726.73,
8956.56,
nullo,
nullo
],
[
nullo,
nullo,
nullo,
nullo,
nullo,
nullo,
nullo
],
[
245.3,
6,5,
-910,
15726.73,
8956.56,
nullo,
nullo
]
],
"gmtTime": "2024/2/22 3:45:15"
},
{
"sn": "3FE34ABE",
"valori":[
[
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"
}
],
"riuscito": vero,
"messaggio": null
}
Recuperare i valori kWh orari/giornalieri per la generazione degli inverter e lo scambio di rete (sia esportati che importati)
URL：https://www.iammeter.com/api/v1/site/energyhistory/?Ora di inizio={2024-05-05}&Tempo scaduto={2024-07-07}&raggruppa per=&Gettone={2be6d1xxxxxxcc688}
Metodo: Ottenere
Limite：
groupby = giorno: dati di 90 giorni (dati di 90 pezzi)
groupby = ora: dati su 7 giorni (dati su 168 pezzi)
| Nome | Tipo | Des | Esempio | |
|---|---|---|---|---|
| Gettone | Corda | gettone del conto | xxx | necessario |
| luogo_ID | numero | ID del luogo | necessario | |
| Ora di inizio | corda | ora di inizio di questo ritorno API | 2023-09-01 | necessario |
| Tempo scaduto | corda | ora di arresto di questo ritorno API | 2023-09-07 | necessario |
| grouphy | enum | seleziona l'intervallo dei dati di ritorno (ora/giorno) | giorno/ora | necessario |
Luogo_ID: I miei luoghi->Modifica
place_id:1360
startTime=2024-05-05
endTime=2024-05-07
groupby=giorno
{
"dati": [{
"ora": "2024/5/5 0:00:00",
"rendimento": 0,
"daGrid": 9.62,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "2024/5/6 0:00:00",
"rendimento": 0,
"daGrid": 9.16,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
}
],
"di successo": vero,
"messaggio": null
}place_id:2393
startTime=2024-05-05
endTime=2024-05-07
groupby=giorno
{
"dati": [{
"ora": "2024/5/5 0:00:00",
"rendimento": 0,
"daGrid": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "2024/5/6 0:00:00",
"rendimento": 0,1,
"daGrid": 0,22,
"toGrid": 7.15,
"Carico speciale": 0,
"autoutilizzo": 0
}
],
"di successo": vero,
"messaggio": null
}place_id:2393
startTime=2024-05-05
endTime=2024-05-06
groupby=ora
{
"dati": [{
"ora": "2024/5/5 0:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "2024/5/5 1:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 2:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 3:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 4:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 5:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 6:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 7:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 8:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 9:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 10:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 11:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 12:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 13:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 14:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 15:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 16:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 17:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 18:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 19:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/5/2024 20:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/2024/5/21:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/2024/5/22:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
},
{
"ora": "5/2024/5/23:00:00",
"rendimento": 0,
"daGriglia": 0,
"toGrid": 0,
"Caricospeciale": 0,
"autoutilizzo": 0
}
],
"di successo": vero,
"messaggio": null
}API del contatore di energia WiFi
Quali funzionalità offre IAMMETER?
Quale tipologia di contatore elettrico si adatta meglio alle tue esigenze?
Come trovare il misuratore di potenza per quanto riguarda le vostre esigenze
Usa il misuratore di energia 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)