IAMMETER-cloud ponuja nekatere API-je, s katerimi lahko razvijalci opravljajo zanimiva dela, na primer integracijo podatkov IAMMETER v sisteme tretjih oseb. Do zdaj smo te API-je odprli le našim poslovnim partnerjem in nekaterim večjim strankam, zdaj pa smo se odločili, da jih odpremo vsem našim strankam.
Veseli bomo, če nam na našem forumu sporočite svoje mnenje. https://imeter.club
API-ji niso na voljo brez omejitev; za vsak API bomo omejili dnevno število klicev. Prosimo, da API-jev ne kličete pogosteje, kot je potrebno.
Če število klicev preseže urno ali dnevno omejitev, API ne vrne ničesar.
| Št. | API | vrsta omejitve | urno | dnevno | opis |
|---|---|---|---|---|---|
| 1 | /user/login | ip | 5 | 30 | enemu IP-ju je dovoljeno klicati ta API 5-krat na uro |
| 2 | /site/meterdata/ | SN | 12 | enemu SN je dovoljeno klicati ta API 12-krat na uro | |
| 3 | /site/powerAnalysis | SN | 5 | enemu SN je dovoljeno klicati ta API 5-krat na dan | |
| 4 | /site/offlineAnalysis | SN | 5 | enemu SN je dovoljeno klicati ta API 5-krat na dan |
Vrne žeton računa. Žeton bo uporabljen v skoraj vseh API-jih.
Tega API-ja vam ni treba klicati, razen če želite osvežiti žeton. Prosimo, tega API-ja ne kličite več kot 5-krat na uro in ne več kot 30-krat na dan.
Pridobivanje žetona računa, ki se uporablja v vseh API-jih.
URL: https://www.iammeter.com/api/v1/user/login
Metoda: post
Ta API lahko preizkusite na spletu v IAMMETER SwaggerUI pridobivanje žetona
| Št. | parameter | opomba | primer |
|---|---|---|---|
| 1 | uporabniško ime | Uporabniško ime IAMMETER | test |
| 2 | geslo | geslo IAMMETER | 123456 |
Vrednost žetona bo uporabljena v vseh spodaj navedenih API-jih.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
Ta žeton lahko neposredno preberete tudi po prijavi v sistem.
Pridobivanje zadnjih poslanih podatkov za določen SN.
Prosimo, tega API-ja ne kličite več kot 12-krat na uro.
Osnovni (meterdata)：https://www.iammeter.com/api/v1/site/meterdata/
Ta API lahko preizkusite na spletu v IAMMETER SwaggerUI
Napredni (meterdata2)：https://www.iammeter.com/api/v1/site/meterdata2/
Ta API lahko preizkusite na spletu v IAMMETER SwaggerUI meterdata in IAMMETER SwaggerUI meterdata2
Metoda：GET
Omejitev：tega API-ja ne zahtevajte več kot 288-krat na dan (interval 5 minut).
Razlika med osnovnim in naprednim:
Osnovni: brez PF (faktorja moči)
Napredni: z PF (faktorjem moči)
| Ime | Vrsta | Primer | |
|---|---|---|---|
| Token | String | xxx | obvezno |
| rtctime | string | 2025-6-16 | neobvezno |
definicija vrednosti: napetost, tok, delovna moč, prejeta kWh, oddana 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
}
definicija vrednosti: napetost, tok, delovna moč, faktor moči, prejeta kWh, oddana kWh.
Zavedamo se, da postavitev faktorja moči med delovno moč in prejeto energijo ni optimalna, a je trenutni format že takšen – upoštevajte to razporeditev.
{
"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
}
Trije nizi v values predstavljajo fazo A, fazo B in fazo C.
definicija vrednosti: napetost, tok, delovna moč, prejeta kWh, oddana 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
}
definicija elementov: napetost, tok, delovna moč, faktor moči, prejeta kWh, oddana 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 (ura realnega časa) je prav tako parameter v zahtevku HTTP GET, kot je prikazano spodaj:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
Ta zahtevek vrne poslano vrednost podatkov števca, ki je najbližja navedenemu datumu (2025-6-16), to pomeni najbližjo zabeleženo časovno točko.
Opomba：ti API-ji so enaki kot v prejšnjem poglavju, le da dodajo še nekaj parametrov.
Vrne zgodovinske podatke za nastavljen interval in časovno območje.
Trenutni podatki so na voljo v 1-minutnem intervalu. Na dan je 60*24=1440 podatkov. Če zahtevate zgodovinske podatke v 1-minutnem intervalu, lahko zahtevate podatke le za 1,39 (2000/1440) dni. Če pa zahtevate podatke v 5-minutnem intervalu, lahko zahtevate podatke za skoraj 7 dni.
Osnovni (meterdatalist)：https://www.iammeter.com/api/v1/site/meterdatalist/
Napredni (meterdatalist2)：https://www.iammeter.com/api/v1/site/meterdatalist2/
Razlika med osnovnim in naprednim:
Osnovni: brez PF (faktorja moči)
Napredni: z PF (faktorjem moči)
Ta API lahko preizkusite na spletu v IAMMETER SwaggerUI meterdata in IAMMETER SwaggerUI meterdata2
| Ime | Vrsta | Primer | |
|---|---|---|---|
| Token | String | xxx | obvezno |
| interval | number | 300 | obvezno, enota: sekunda |
| startTime | string | 2023-09-01 | obvezno |
| endTime | string | 2023-09-07 | obvezno |
Podatki: [napetost, tok, moč, prejeta energija, oddana energija, UTC čas, lokalni čas]
{
"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
}
Vrne rezultat analize moči v navedenem času.
Prosimo, tega API-ja ne kličite več kot 5-krat na dan.
URL：https://www.iammeter.com/api/v1/site/powerAnalysis
Metoda：get
Omejitev：tega API-ja ne zahtevajte več kot 5-krat na dan za posamezni SN.
| Ime | Vrsta | Primer | |
|---|---|---|---|
sn |
String | xxx | obvezno |
startTime |
String | 2023-09-01 | neobvezno |
endTime |
String | 2023-09-07 | neobvezno |
Opomba:
average: povprečni odčitek moči v tem časovnem območju.
averageDaytime: povprečni dnevni (8:00–20:00) odčitek moči v tem časovnem območju.
minimum: najmanjši odčitek moči v tem časovnem območju.
maximum: največji odčitek moči v tem časovnem območju.
{
"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
}
Vrnitev rezultata analize moči za zadnjih 7 dni.
Vrnitev rezultata analize moči za določen dan
Vrne stanje prekinjene povezave za določen SN v navedenem času.
Prosimo, tega API-ja ne kličite več kot 5-krat na dan.
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
Metoda：Get
Omejitev：tega API-ja ne zahtevajte več kot 5-krat na dan za posamezni SN.
| Ime | Vrsta | Primer | |
|---|---|---|---|
sn |
String | xxxx | obvezno |
startTime |
String | 2023-09-01 | neobvezno |
endTime |
String | 2023-09-07 | neobvezno |
interval (enota: minuta) |
Number | 5 | neobvezno |
Opomba:
V tem časovnem območju je skupaj 10080 minut.
Skupni čas brez povezave v tem časovnem območju je 906 minut.
V nizu so navedene prekinitve, daljše od 5 minut.
{
"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
}
Vrnitev rezultata analize brez povezave za določen dan
Vrne najnovejše vrednosti vseh energijskih števcev v tem računu.
URL：https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Metoda：Get
Omejitev：poskrbite, da tega API-ja ne boste klicali pogosteje kot enkrat na 5 minut.
| Ime | Vrsta | Primer | |
|---|---|---|---|
| Token | String | xxx | obvezno |
{
"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
}
Pridobivanje urnih/dnevnih vrednosti kWh za proizvodnjo razsmernika in izmenjavo z omrežjem (tako oddano kot prejeto).
URL：https://www.iammeter.com/api/v1/site/energyhistory/?startTime={2024-05-05}&endTime={2024-07-07}&groupby=&Token={2be6d1xxxxxxcc688}
Metoda：get
Omejitev：
groupby = day: 90 dni podatkov (90 kosov podatkov)
groupby = hour: 7 dni podatkov (168 kosov podatkov)
| Ime | Vrsta | Opis | Primer | |
|---|---|---|---|---|
| Token | String | žeton računa | xxx | obvezno |
| place_ID | number | ID lokacije | obvezno | |
| startTime | string | začetni čas, ki ga vrne ta API | 2023-09-01 | obvezno |
| endTime | string | končni čas, ki ga vrne ta API | 2023-09-07 | obvezno |
| groupby | enum | izbira intervala vrnjenih podatkov (ura/dan) | day/hour | obvezno |
Place_ID：Moje lokacije -> Uredi
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
}
Katere zmogljivosti ponuja IAMMETER?
Katera vrsta električnega števca najbolj ustreza vašim potrebam?
Kako najti števec moči glede na vaše zahteve
Uporabite trifazni energijski števec na način, ki vam ustreza
Trifazni Wi-Fi merilnik energije (WEM3080T)
Enofazni Wi-Fi merilnik energije (WEM3080)
Trifazni Wi-Fi merilnik energije (WEM3046T)
Trifazni Wi-Fi merilnik energije (WEM3050T)