IAMMETER-cloud oferă câteva API-uri, iar dezvoltatorii le pot folosi pentru a realiza lucruri interesante, cum ar fi integrarea datelor IAMMETER într-un sistem terț. Până acum am deschis aceste API-uri doar partenerilor noștri de afaceri și unor clienți importanți, dar am decis să le deschidem acum tuturor clienților noștri.
Vă invităm să ne împărtășiți părerea dumneavoastră pe forumul nostru. https://imeter.club
API-urile nu pot fi accesate nelimitat; vom limita numărul zilnic de apeluri pentru fiecare API. Vă rugăm să nu apelați API-urile prea frecvent.
Dacă numărul de apeluri depășește limita orară sau zilnică, API-ul nu va returna nimic.
| Nr. | API | tip de limită | orar | zilnic | descriere |
|---|---|---|---|---|---|
| 1 | /user/login | ip | 5 | 30 | un singur IP poate apela acest API de 5 ori pe oră |
| 2 | /site/meterdata/ | SN | 12 | un singur SN poate apela acest API de 12 ori pe oră | |
| 3 | /site/powerAnalysis | SN | 5 | un singur SN poate apela acest API de 5 ori pe zi | |
| 4 | /site/offlineAnalysis | SN | 5 | un singur SN poate apela acest API de 5 ori pe zi |
Returnează tokenul contului. Tokenul va fi folosit în aproape toate API-urile.
Nu este necesar să apelați acest API decât dacă doriți să reîmprospătați tokenul. Vă rugăm să nu apelați acest API de mai mult de 5 ori într-o oră și de cel mult 30 de ori într-o zi.
Obțineți tokenul contului care este utilizat în toate API-urile.
URL: https://www.iammeter.com/api/v1/user/login
Metodă: post
Acest API poate fi testat online în IAMMETER SwaggerUI pentru obținerea tokenului
| Nr. | parametru | observații | exemplu |
|---|---|---|---|
| 1 | user name | Numele de utilizator IAMMETER | test |
| 2 | password | parola contului IAMMETER | 123456 |
Valoarea tokenului va fi folosită în toate API-urile de mai jos.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
Acest token poate fi citit direct după ce vă autentificați în sistem.
Obțineți ultimele date încărcate pentru SN-ul respectiv.
Vă rugăm să nu apelați acest API de mai mult de 12 ori într-o oră.
Basic(meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Acest API poate fi testat online în IAMMETER SwaggerUI
Advanced(meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Acest API poate fi testat online în IAMMETER SwaggerUI meterdata și IAMMETER SwaggerUI meterdata2
Metodă: GET
Limită: vă rugăm să nu solicitați acest API de mai mult de 288 de ori pe zi (interval de 5 minute).
Diferența dintre basic și advanced:
Basic: fără PF (factor de putere)
Advanced: cu PF (factor de putere)
| Nume | Tip | Exemplu | |
|---|---|---|---|
| Token | String | xxx | obligatoriu |
| rtctime | string | 2025-6-16 | opțional |
definiția valorilor: voltage, current, active power, imported kWh, exported kWh
{
"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
}
definiția valorilor: voltage, current, active power, power factor, imported kWh, exported kWh.
Deși recunoaștem că plasarea factorului de putere între puterea activă și energia importată nu este optimă, formatul actual este deja configurat astfel — vă rugăm să țineți cont de această structură
{
"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
}
Cele trei tablouri din values reprezintă faza A, faza B și faza C.
definiția valorilor: voltage, current, active power, imported kWh, exported kWh
{
"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
}
definiția elementelor: voltage, current, active power, power factor, imported kWh, exported kWh
{
"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
}
RTC (Real-Time Clock) este, de asemenea, un parametru al cererii HTTP GET, așa cum se arată mai jos:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
Această cerere va returna valoarea datelor de contor încărcate cea mai apropiată de data specificată (2025-6-16), adică cel mai apropiat moment de timp înregistrat.
Notă: aceste API-uri sunt aceleași ca în capitolul anterior, doar că au câțiva parametri în plus
Returnează datele istorice pentru intervalul de timp setat.
Datele instantanee sunt la interval de 1 minut. Există 60*24=1440 de înregistrări de date pe zi. Dacă solicitați datele istorice la interval de 1 minut, puteți solicita doar datele a 1,39 (2000/1440) zile. Dar dacă solicitați datele la interval de 5 minute, puteți solicita datele a aproape 7 zile.
Basic(meterdatalist):https://www.iammeter.com/api/v1/site/meterdatalist/
**Advanced(meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Diferența dintre basic și advanced:
Basic: fără PF (factor de putere)
Advanced: cu PF (factor de putere)
Acest API poate fi testat online în IAMMETER SwaggerUI meterdata și IAMMETER SwaggerUI meterdata2
| Nume | Tip | Exemplu | |
|---|---|---|---|
| Token | String | xxx | obligatoriu |
| interval | number | 300 | obligatoriu, unitate: secundă |
| startTime | string | 2023-09-01 | obligatoriu |
| endTime | string | 2023-09-07 | obligatoriu |
Date: [voltage, current, power, import energy, export energy, utc time, local time]
{
"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
}
Returnează rezultatul analizei de putere pentru perioada specificată.
Vă rugăm să nu apelați acest API de mai mult de 5 ori într-o zi.
URL:https://www.iammeter.com/api/v1/site/powerAnalysis
Metodă: get
Limită: vă rugăm să nu solicitați acest API pentru un SN de mai mult de 5 ori pe zi.
| Nume | Tip | Exemplu | |
|---|---|---|---|
sn |
String | xxx | obligatoriu |
startTime |
String | 2023-09-01 | opțional |
endTime |
String | 2023-09-07 | opțional |
Notă:
average: citirea medie a puterii în acest interval de timp.
averageDaytime: citirea medie a puterii în timpul zilei (8:00-20:00) în acest interval de timp.
minimum: citirea minimă a puterii în acest interval de timp.
maximum: citirea maximă a puterii în acest interval de timp.
{
"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
}
Returnează rezultatul analizei de putere pentru ultimele 7 zile.
Returnează rezultatul analizei de putere pentru ziua specificată
Returnează starea de deconectare pentru SN-ul respectiv în perioada specificată.
Vă rugăm să nu apelați acest API de mai mult de 5 ori într-o zi.
URL: https://www.iammeter.com/api/v1/site/offlineAnalysis
Metodă: Get
Limită: vă rugăm să nu solicitați acest API pentru un SN de mai mult de 5 ori pe zi.
| Nume | Tip | Exemplu | |
|---|---|---|---|
sn |
String | xxxx | obligatoriu |
startTime |
String | 2023-09-01 | opțional |
endTime |
String | 2023-09-07 | opțional |
interval (unitate: minut) |
Number | 5 | opțional |
Notă:
În acest interval de timp sunt în total 10080 de minute.
Timpul total offline este de 906 minute în acest interval de timp.
Intervalele offline mai mari de 5 minute sunt listate în tablou.
{
"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
}
Returnează rezultatul analizei offline pentru ziua specificată
Returnează ultima valoare a tuturor contoarelor de energie din acest cont.
URL: https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Metodă: Get
Limită: vă rugăm să vă asigurați că nu trimiteți cereri către acest API mai frecvent decât o dată la fiecare 5 minute.
| Nume | Tip | Exemplu | |
|---|---|---|---|
| Token | String | xxx | obligatoriu |
{
"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
}
Obțineți valorile kWh orare/zilnice pentru generarea invertorului și schimbul cu rețeaua (atât exportat, cât și importat)
Metodă: get
Limită:
groupby = day: date pentru 90 de zile (90 de înregistrări)
groupby = hour: date pentru 7 zile (168 de înregistrări)
| Nume | Tip | Descriere | Exemplu | |
|---|---|---|---|---|
| Token | String | tokenul contului | xxx | obligatoriu |
| place_ID | number | ID-ul locației | obligatoriu | |
| startTime | string | timpul de început returnat de acest API | 2023-09-01 | obligatoriu |
| endTime | string | timpul de oprire returnat de acest API | 2023-09-07 | obligatoriu |
| groupby | enum | selectează intervalul datelor returnate (hour/day) | day/hour | obligatoriu |
Place_ID: My Places->Edit
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 al contorului de energie WiFi
Ce tip de contor electric se potrivește cel mai bine nevoilor dumneavoastră?
Cum găsiți contorul de putere în funcție de cerințele dumneavoastră
Contor de energie Wi-Fi trifazat (WEM3080T)
Contor de energie Wi-Fi monofazat (WEM3080)
Contor de energie Wi-Fi trifazat (WEM3046T)
Contor de energie Wi-Fi trifazat (WEM3050T)