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'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.
| No. | API | tipus de límit | cada hora | Diàriament | descripció |
|---|---|---|---|---|---|
| 1 | /usuari/inici de sessió | ip | 5 | 30 | una IP només podrà trucar a aquesta API 5 vegades per hora |
| 2 | /site/meterdata/ | SN | 12 | un SN només pot trucar a aquesta API 12 vegades per hora | |
| 3 | /site/powerAnalysis | SN | 5 | un SN només pot trucar a aquesta API 5 vegades al dia | |
| 4 | /site/offlineAnalysis | SN | 5 | un SN només pot trucar a aquesta API 5 vegades al dia |
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.
Obteniu el testimoni del compte que s'utilitza a totes les API.
URL:https://www.iammeter.com/api/v1/user/login
Mètode:publicació
| No. | paràmetre | observació | exemple |
|---|---|---|---|
| 1 | nom d'usuari | Nom d'usuari de IAMMETER | prova |
| 2 | contrasenya | contrasenya de IAMMETER | 123456 |
El valor del testimoni s'utilitzarà a totes les API següents.
{
"dades": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"èxit": cert,
"missatge": nul
}Aquest testimoni també es pot llegir directament després d'iniciar sessió al sistema.
Obteniu les darreres dades de càrrega amb el SN considerat.
No truqueu a aquesta API més de 12 vegades en una hora.
Bàsic (dades de mesura): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Avançat (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
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)
| Nom | Tipus | Exemple | |
|---|---|---|---|
| Token | Corda | xxx | requerit |
definició de valors: tensió, corrent, potència activa, Kwh importats, Kwh exportats
{
"dades": {
"valors": [
[
230.220,
1.300,
119.000,
1766.590,
0.000
]
],
"localTime": "2020/8/28 15:27:33",
"gmtTime": "2020/8/28 5:27:33"
},
"èxit": cert,
"missatge": nul
}definició de valors: tensió, corrent, potència activa,factor de potència,Kwh importats, Kwh exportats
{
"dades":{
"valors":[
[
233,41,
0,718,
111,
0,66,
5724,85,
0
]
],
"localTime":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"èxit":cert,
"missatge":null
}Les tres matrius avalorsrepresenten la fase A, la fase B i la fase C.
Definició d'elements: tensió, corrent, potència activa,factor de potència,Kwh importats, Kwh exportats
{
"dades": {
"valors": [
[
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"
},
"èxit": cert,
"missatge": nul
}{
"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
}
Retorna les dades històriques de l'interval i l'interval de temps establerts.
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.
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)
| Nom | Tipus | Exemple | |
|---|---|---|---|
| Token | Corda | xxx | requerit |
| interval | nombre | 300 | requerit, unitat: segon |
| l'hora d'inici | corda | 2023-09-01 | requerit |
| fi del temps | corda | 2023-09-07 | requerit |
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
}{
"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
}{
"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
}
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: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.
| Nom | Tipus | Exemple | |
|---|---|---|---|
sn |
Corda | xxx | requerit |
l'hora d'inici |
Corda | 2023-09-01 | opcional |
fi del temps |
Corda | 2023-09-07 | opcional |
Nota:
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
}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
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：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.
| Nom | Tipus | Exemple | |
|---|---|---|---|
sn |
Corda | xxxx | requerit |
l'hora d'inici |
Corda | 2023-09-01 | opcional |
fi del temps |
Corda | 2023-09-07 | opcional |
interval(unitat: minut) |
Número | 5 | opcional |
Nota:
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
}Retorna el resultat de l'anàlisi fora de línia del dia especificat
API del comptador d'energia WiFi
Comptador d'energia WiFi trifàsica
Utilitzeu el comptador d'energia trifàsic de la manera que preferiu
Mesurador d'energia Wi-Fi trifàsic
Mesurador d'energia Wi-Fi monofàsic