IAMMETER-cloud tarjoaa useita API-rajapintoja, ja kehittäjät voivat käyttää näitä rajapintoja mielenkiintoiseen työhön, kuten IAMMETERin tietojen integroimiseen kolmannen osapuolen järjestelmiin. Aiemmin avasimme nämä rajapinnat vain liikekumppaneillemme ja suurille asiakkaillemme, mutta päätimme nyt avata ne kaikille asiakkaillemme.
Tervetuloa kertomaan ajatuksistasi foorumillamme. https://imeter.club
API:a ei voi kutsua rajoituksetta; rajoitamme kunkin API:n päivittäistä kutsukertojen määrää. Älä kutsu API:a liian usein.
Jos kutsukertojen määrä ylittää tunti- tai päiväkohtaisen rajan, API ei palauta mitään.
| No. | API | rajoituksen tyyppi | tunnissa | päivässä | kuvaus |
|---|---|---|---|---|---|
| 1 | /user/login | ip | 5 | 30 | yksi IP-osoite saa kutsua tätä API:a 5 kertaa tunnissa |
| 2 | /site/meterdata/ | SN | 12 | yksi SN saa kutsua tätä API:a 12 kertaa tunnissa | |
| 3 | /site/powerAnalysis | SN | 5 | yksi SN saa kutsua tätä API:a 5 kertaa päivässä | |
| 4 | /site/offlineAnalysis | SN | 5 | yksi SN saa kutsua tätä API:a 5 kertaa päivässä |
Palauttaa tilin tunnuksen (token). Tunnusta käytetään lähes kaikissa API-rajapinnoissa.
Tätä API:a ei tarvitse kutsua, ellet halua päivittää tunnusta. Älä kutsu tätä API:a yli 5 kertaa tunnissa äläkä yli 30 kertaa päivässä.
Hae kaikissa API-rajapinnoissa käytettävä tilin tunnus.
URL: https://www.iammeter.com/api/v1/user/login
Metodi: post
Tätä API:a voi testata verkossa osoitteessa IAMMETER SwaggerUI get token
| No. | parametri | huomautus | esimerkki |
|---|---|---|---|
| 1 | user name | IAMMETERin käyttäjänimi | test |
| 2 | password | IAMMETERin salasana | 123456 |
Tunnuksen arvoa käytetään kaikissa alla olevissa API-rajapinnoissa.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
Tunnuksen voi lukea myös suoraan järjestelmään kirjautumisen jälkeen.
Hae viimeisimmät lähetetyt tiedot annetulla SN-tunnuksella.
Älä kutsu tätä API:a yli 12 kertaa tunnissa.
Basic(meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Tätä API:a voi testata verkossa osoitteessa IAMMETER SwaggerUI
Advanced(meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Tätä API:a voi testata verkossa osoitteessa IAMMETER SwaggerUI meterdata ja IAMMETER SwaggerUI meterdata2
Metodi: GET
Rajoitus: älä kutsu tätä API:a yli 288 kertaa päivässä (5 minuutin välein).
Ero perus- ja laajennetun version välillä:
Basic: ilman PF:ää (power factor, tehokerroin)
Advanced: PF:n kanssa (power factor, tehokerroin)
| Nimi | Tyyppi | Esimerkki | |
|---|---|---|---|
| Token | String | xxx | pakollinen |
| rtctime | string | 2025-6-16 | valinnainen |
arvojen määritelmä: 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
}
arvojen määritelmä: voltage, current, active power, power factor, imported kWh, exported kWh.
Vaikka ymmärrämme, että tehokertoimen sijoittaminen aktiivitehon ja tuodun energian väliin ei ole optimaalista, nykyinen muoto on jo rakennettu tällä tavalla — ota tämä järjestely huomioon
{
"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
}
values-taulukon kolme matriisia edustavat vaihetta A, vaihetta B ja vaihetta C.
arvojen määritelmä: 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
}
elementtien määritelmä: 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, reaaliaikakello) on myös parametri HTTP GET -pyynnössä, kuten alla näkyy:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
Tämä pyyntö palauttaa lähetetyn mittaritiedon arvon, joka on lähimpänä määritettyä päivämäärää (2025-6-16), eli lähimmän tallennetun ajankohdan.
Huom: nämä API:t ovat samoja kuin edellisessä luvussa, vain muutamia lisäparametreja on lisätty
Palauttaa historiatiedot määritetyllä aikavälillä ja ajanjaksolla.
Pikadata on 1 minuutin välein. Vuorokaudessa on 60*24=1440 datakappaletta. Jos pyydät historiatietoja 1 minuutin välein, voit pyytää vain 1,39 (2000/1440) vuorokauden tiedot. Mutta jos pyydät tietoja 5 minuutin välein, voit pyytää lähes 7 vuorokauden tiedot.
Basic(meterdatalist):https://www.iammeter.com/api/v1/site/meterdatalist/
**Advanced(meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Ero perus- ja laajennetun version välillä:
Basic: ilman PF:ää (power factor, tehokerroin)
Advanced: PF:n kanssa (power factor, tehokerroin)
Tätä API:a voi testata verkossa osoitteessa IAMMETER SwaggerUI meterdata ja IAMMETER SwaggerUI meterdata2
| Nimi | Tyyppi | Esimerkki | |
|---|---|---|---|
| Token | String | xxx | pakollinen |
| interval | number | 300 | pakollinen, yksikkö: sekunti |
| startTime | string | 2023-09-01 | pakollinen |
| endTime | string | 2023-09-07 | pakollinen |
Tiedot: [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
}
Palauttaa tehonanalyysin tuloksen määritettynä aikana.
Älä kutsu tätä API:a yli 5 kertaa päivässä.
URL:https://www.iammeter.com/api/v1/site/powerAnalysis
Metodi: get
Rajoitus: älä pyydä tätä API:a kutakin SN:ää kohden yli 5 kertaa päivässä.
| Nimi | Tyyppi | Esimerkki | |
|---|---|---|---|
sn |
String | xxx | pakollinen |
startTime |
String | 2023-09-01 | valinnainen |
endTime |
String | 2023-09-07 | valinnainen |
Huom:
average: keskimääräinen tehon lukema tällä aikavälillä.
averageDaytime: keskimääräinen päiväaikainen (klo 8.00–20.00) tehon lukema tällä aikavälillä.
minimum: pienin tehon lukema tällä aikavälillä.
maximum: suurin tehon lukema tällä aikavälillä.
{
"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
}
Palauta viimeisten 7 päivän tehonanalyysin tulos.
Palauta määritetyn päivän tehonanalyysin tulos
Palauttaa yhteyden katkeamisen tilan annetulla SN-tunnuksella määritettynä aikana.
Älä kutsu tätä API:a yli 5 kertaa päivässä.
URL: https://www.iammeter.com/api/v1/site/offlineAnalysis
Metodi: Get
Rajoitus: älä pyydä tätä API:a kutakin SN:ää kohden yli 5 kertaa päivässä.
| Nimi | Tyyppi | Esimerkki | |
|---|---|---|---|
sn |
String | xxxx | pakollinen |
startTime |
String | 2023-09-01 | valinnainen |
endTime |
String | 2023-09-07 | valinnainen |
interval(yksikkö: minuutti) |
Number | 5 | valinnainen |
Huom:
Tällä aikavälillä on yhteensä 10080 minuuttia.
Offline-aikaa on tällä aikavälillä yhteensä 906 minuuttia.
Yli 5 minuutin pituiset offline-jaksot on lueteltu taulukossa (array).
{
"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
}
Palauta määritetyn päivän offline-analyysin tulos
Palauttaa kaikkien tämän tilin energiamittareiden uusimmat arvot.
URL: https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Metodi: Get
Rajoitus: varmista, että et tee pyyntöjä tähän API:hin useammin kuin kerran 5 minuutissa.
| Nimi | Tyyppi | Esimerkki | |
|---|---|---|---|
| Token | String | xxx | pakollinen |
{
"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
}
Hae invertterin tuotannon ja sähköverkon vaihdon (sekä viedyn että tuodun energian) tunneittaiset/päivittäiset kWh-arvot
Metodi: get
Rajoitus:
groupby = day: 90 päivän tiedot (90 kpl)
groupby = hour: 7 päivän tiedot (168 kpl)
| Nimi | Tyyppi | Kuvaus | Esimerkki | |
|---|---|---|---|---|
| Token | String | tilin tunnus | xxx | pakollinen |
| place_ID | number | paikan ID | pakollinen | |
| startTime | string | tämän API:n palauttaman ajan alkuaika | 2023-09-01 | pakollinen |
| endTime | string | tämän API:n palauttaman ajan loppuaika | 2023-09-07 | pakollinen |
| groupby | enum | valitse palautettavan datan aikaväli (hour/day) | day/hour | pakollinen |
Place_ID: Omat paikat (My Places) -> Muokkaa (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
}
Mitä ominaisuuksia IAMMETER tarjoaa?
Mikä sähkömittarityyppi sopii parhaiten tarpeisiisi?
Miten löydät tarpeitasi vastaavan tehomittarin
Kolmivaiheinen Wi-Fi-energiamittari (WEM3080T)
Yksivaiheinen Wi-Fi-energiamittari (WEM3080)
Kolmivaiheinen Wi-Fi-energiamittari (WEM3046T)
Kolmivaiheinen Wi-Fi-energiamittari (WEM3050T)