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
API del contatore di energia WiFi
Contatore di energia WiFi trifase
Usa il misuratore di energia trifase nel modo che preferisci
Contatore di energia Wi-Fi trifase
Contatore di energia Wi-Fi monofase