IAMMETER-pilvi tarjoaa joitain sovellusliittymiä, ja kehittäjä voi käyttää näitä API-liittymiä tehdäkseen mielenkiintoisia töitä, kuten integroidakseen IAMMETERin tietoja johonkin kolmannen osapuolen järjestelmään. Avasimme juuri nämä API:t liikekumppaneillemme ja joillekin suurille asiakkaillemme aiemmin, mutta päätimme avata ne kaikille asiakkaillemme nyt.
Tervetuloa kertomaan meille mielipiteesi foorumillamme.https://imeter.club
API:ssa ei voi vierailla rajattomasti, rajoitamme kunkin API:n päivittäistä puhelumäärää. Älä soita API:lle useammin.
Jos puhelujen määrä ylittää tunti- tai päivärajoituksen, API ei palauta mitään.
| Ei. | API | rajan tyyppi | Tunneittain | Päivittäin | Kuvaus |
|---|---|---|---|---|---|
| 1 | /käyttäjän kirjautuminen | ip | 5 | 30 | yksi IP saa kutsua tätä api:tä vain 5 kertaa tunnissa |
| 2 | /site/meterdata/ | SN | 12 | yksi SN saa soittaa tälle apille vain 12 kertaa tunnissa | |
| 3 | /site/powerAnalysis | SN | 5 | yksi SN saa soittaa tälle apille vain 5 kertaa päivässä | |
| 4 | /site/offlineAnalysis | SN | 5 | yksi SN saa soittaa tälle apille vain 5 kertaa päivässä |
Palauta tilin tunnus. Tunnusta käytetään lähes kaikissa API:ssa.
Sinun ei tarvitse kutsua tätä sovellusliittymää, ellet halua päivittää tunnusta.Älä kutsu tätä API:ta enempää kuin 5 kertaa tunnissa ja enintään 30 kertaa yhden päivän aikana.
Hanki tilin tunnus, jota käytetään kaikissa sovellusliittymissä.
URL-osoite:https://www.iammeter.com/api/v1/user/login
Menetelmä:lähettää
Tätä API:a voidaan testata verkossa osoitteessaIAMMETER SwaggerUI hakutunnus
| Ei. | parametri | Huomautus | Esimerkki |
|---|---|---|---|
| 1 | käyttäjänimi | IAMMETERin käyttäjätunnus | testata |
| 2 | Salasana | IAMMETERin salasana | 123456 |
Tunnusarvoa käytetään kaikissa alla olevissa sovellusliittymissä.
{
"tiedot": {
"ID": 2025,
"tunnus": "349dfxxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"onnistunut": totta,
"viesti": tyhjä
}
Tämä tunnus voidaan lukea myös heti, kun olet kirjautunut järjestelmään.

Hanki viimeisimmät lähetystiedot katsotulla SN:llä.
Älä kutsu tätä API:ta enempää kuin 12 kertaa tunnin aikana.
Perus (mittaritiedot): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Tätä API:a voidaan testata verkossa osoitteessaIAMPERIMETER SwaggerUI
Lisäasetukset (mittaritiedot2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Tätä API:a voidaan testata verkossa osoitteessaIAMPER-mittari SwaggerUI-mittaritiedotjaIAMPERIMETER SwaggerUI -mittaritiedot2
Menetelmä: SAADA
Raja: älä pyydä tätä API:ta enempää kuin 288 kertaa päivässä (5 minuutin välein).
Ero perus- ja edistyneen tason välillä:
Perus: ilman PF:tä (tehokerroin)
Edistynyt: PF:llä (tehokerroin)
| nimi | Tyyppi | Esimerkki | |
|---|---|---|---|
| Token | merkkijono | xxx | edellytetään |
| rtctime | merkkijono | 2025-6-16 | valinnainen |
arvojen määritelmä: jännite,virta,aktiivinen teho,tuotu Kwh, viety Kwh
{
"data": {
"values": [
[ 230.220, //jännite
1.300, //virta
119.000,//pätöteho
1766.590, //tuotu kWh
0.000 //viety kWh
]
],
"localTime": "28.8.2020 15:27:33",
"gmtTime": "28.8.2020 5:27:33"
},
"onnistui": true,
"message": null
}
arvojen määritelmä: jännite, virta, pätöteho,tehokerrointuotu kWh, viety kWh.
Vaikka ymmärrämme, että tehokertoimen sijoittaminen pätötehon ja tuodun energian välille ei ole optimaalista, nykyinen muoto on jo tällä tavalla määritetty – huomioithan tämän järjestelyn.
{
"data":{
"values":[
[
233.41, //jännite
0.718,//virta
111,//pätöteho
0.66,//tehokerroin
5724.85, //tuotu energia
0 //viety energia
]
],
"localTime":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"onnistui":true,
"message":null
}
Kolme taulukkoa sisälläarvotedustavat vaihetta A, vaihetta B ja vaihetta C.
arvojen määritelmä: jännite,virta,aktiivinen teho,tuotu Kwh, viety Kwh
{
"data": {
"arvot": [
[
242,600,//jännite
1,000,//virta
216,000,//pätöteho
32354,600,//tuontienergia
0,000//vientienergia
],
[
242,600, 1,000, 1986,000,
30536,410,
17704,720
],
[
0,000, 0,000, 0,000, 0,000, 0,000
]
],
"paikallinen aika": "28.8.2020 klo 15.30.48",
”gmtTime”: ”28.8.2020 klo 5.30.48”
},
”onnistui”: tosi,
”viesti”: null
}
Elementin määritelmä: jännite, virta, aktiivinen teho,tehokerroin,tuonti Kwh, viety Kwh
{
"tiedot":{
"arvot":[
[//vaihe A
233,8,//jännite
0,03,//nykyinen
4,//aktiivinen teho
0,57,//tehokerroin
222.53,//tuotu Kwh
0 //viety Kwh
],
[//vaihe B
5,
0,
0,
0,
0,
0
],
[ //vaihe C
3.1,
0,
0,
0,
0,
0
]
],
"paikallinen aika": "2023/11/21 14:39:36",
"gmtTime":"2023/11/21 6:39:36"
},
"onnistunut":true,
"viesti":null
}

RTC (Real-Time Clock) on myös parametri HTTP GET -pyynnössä, kuten alla on esitetty:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
Tämä pyyntö palauttaa ladatun mittarin datan arvon, joka on lähimpänä määritettyä päivämäärää (16.6.2025) eli lähimpänä tallennettua ajankohtaa.
Huomautus: nämä API:t ovat samat kuin edellisessä luvussa, niihin on vain lisätty joitakin parametreja.
Palauta historialliset tiedot asetetulla aikavälillä ja aikavälillä.
Välittömät tiedot ovat 1 minuutin välein. Vuorokaudessa on 60*24=1440 dataa. Jos pyydät historiatietoja 1 minuutin välein, voit pyytää vain 1,39(2000/1440) päivän tietoja. Mutta jos pyydät tietoja 5 minuutin välein, voit pyytää lähes 7 päivän tietoja.
Perus(metridatalist):https://www.iammeter.com/api/v1/site/meterdatalist/
**Lisäasetukset(mittaridatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Ero perus- ja edistyneen tason välillä:
Perus: ilman PF:tä (tehokerroin)
Edistynyt: PF:llä (tehokerroin)
Tätä API:a voidaan testata verkossa osoitteessaIAMPER-mittari SwaggerUI-mittaritiedotjaIAMPERIMETER SwaggerUI -mittaritiedot2
| nimi | Tyyppi | Esimerkki | |
|---|---|---|---|
| Token | merkkijono | xxx | edellytetään |
| intervalli | määrä | 300 | vaaditaan, yksikkö: sekunti |
| aloitusaika | merkkijono | 2023-09-01 | edellytetään |
| loppu aika | merkkijono | 2023-09-07 | edellytetään |
Tiedot: [jännite, virta, teho, tuontienergia, vientienergia, UTC-aika, paikallinen aika]
{
"tiedot": [
[
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"
]
],
"onnistunut": totta,
"viesti": tyhjä
}
{
"tiedot": [
[
230,//phaseA jännite
0,//nykyinen
0,//aktiivinen teho
468.41,//tuotu kWh
0,//viety kWh
230,//vaihe B
0,
0,
236,58,
290,77,
230,//Vaihe 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"
]
],
"onnistunut": totta,
"viesti": tyhjä
}
{
"tiedot":[
{ //ensimmäiset tiedot
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"arvot":[
[ //vaihe A
235,2,//jännite
0,03,//nykyinen
4,//aktiivinen teho
0,57,//tehokerroin
210.21,//tuonti Kwh
0 //viety Kwh
],
[//vaihe B
5,5,
0,
0,
0,
0,
0
],
[ //vaihe C
3.3,
0,
0,
0,
0,
0
]
]
},
{ //sekuntidataa
"rtcTime":"2023/9/1 8:00:49",
"gmtTime":"2023/9/1 0:00:49",
"arvot":[
[
233,4,
0,03,
4,
0,57,
210.24,
0
],
[
5.4,
0,
0,
0,
0,
0
],
[
3.3,
0,
0,
0,
0,
0
]
]
},
{ //kolmas data
"rtcTime":"2023/9/1 16:00:24",
"gmtTime":"2023/9/1 8:00:24",
"arvot":[
[
235,6,
0,03,
4,
0,57,
210.27,
0
],
[
5,5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
"onnistunut":true,
"viesti":null
}

Palauta tehoanalyysin tulos määritetyssä ajassa.
Älä kutsu tätä API:ta enempää kuin 5 kertaa päivässä.
url:https://www.iammeter.com/api/v1/site/powerAnalysis
Menetelmä: SAADA
Raja: Älä pyydä tätä APIa per SN useammin kuin 5 kertaa päivässä.
| nimi | Tyyppi | Esimerkki | |
|---|---|---|---|
SN |
merkkijono | xxx | edellytetään |
aloitusaika |
merkkijono | 2023-09-01 | valinnainen |
loppu aika |
merkkijono | 2023-09-07 | valinnainen |
merkintä:
keskiarvo: keskimääräinen teholukema tällä aikavälillä.
keskimääräinen päivä: keskimääräinen päiväaika (8.00–20.00) teholukema tällä aikavälillä.
minimi: pienin teholukema tällä aikavälillä.
maksimi: maksimiteholukema tällä aikavälillä.
{
"tiedot": {
"aloitusaika": "2023-09-01",
"lopunaika": "2023-09-07",
"keskiarvo": 862,6,
"AverageDaytime": 836.9,
"minimi": 259,0,
"maksimi": 3999,0
},
"onnistunut": totta,
"viesti": tyhjä
}
Palauta viimeisen 7 päivän tehoanalyysin tulos.

Palauta määritetyn päivän tehoanalyysin tulos

Palauta katkaisutila tarkastetulla SN:llä määritetyssä ajassa.
Älä kutsu tätä API:ta enempää kuin 5 kertaa päivässä.
url:https://www.iammeter.com/api/v1/site/offlineAnalysis
Menetelmä:Saada
Raja: Älä pyydä tätä API:ta SN:tä kohti enempää kuin 5 kertaa päivässä.
| nimi | Tyyppi | Esimerkki | |
|---|---|---|---|
SN |
merkkijono | xxxx | edellytetään |
aloitusaika |
merkkijono | 2023-09-01 | valinnainen |
loppu aika |
merkkijono | 2023-09-07 | valinnainen |
intervalli(yksikkö :minuutti) |
määrä | 5 | valinnainen |
merkintä:
Tällä aikavälillä on yhteensä 10080 minuuttia.
Koko offline-aika on 906 minuuttia tällä aikavälillä.
Yli 5 minuuttia kestävä offline-aikaväli on lueteltu taulukossa.
{
"tiedot": {
"aloitusaika": "2023-09-05",
"EndTime": "2023-09-11",
"offlineCount": 906,
"totalCount": 10080,
"lista": [
{
"aloitusaika": "2023/9/5 0:00:00",
"lopunaika": "2023/9/5 15:06:14",
"kesto": 906
}
]
},
"onnistunut": totta,
"viesti": tyhjä
}
Palauta määritetyn päivän offline-analyysitulos

Palauta kaikkien tämän tilin energiamittarien viimeisin arvo.
url:https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Menetelmä:Saada
Raja: Varmista, että et tee pyyntöjä tälle API:lle useammin kuin kerran 5 minuutin välein.
| nimi | Tyyppi | Esimerkki | |
|---|---|---|---|
| Token | merkkijono | xxx | edellytetään |
{
"tiedot":[
{
"sn": "DA2BED94",
"arvot":[
223,71,
1,74,
225,
14761.03,
0
],
"gmtTime":"2024/2/22 3:46:20"
},
{
"sn":"B384789C",
"arvot":[
[
248,9,
13.9,
3356,
21228,
0,
tyhjä,
tyhjä
],
[
248,9,
13.9,
-2747,
8988.48,
18489.44,
tyhjä,
tyhjä
],
[
tyhjä,
tyhjä,
tyhjä,
tyhjä,
tyhjä,
tyhjä,
tyhjä
],
[
248,9,
13.9,
-2747,
8988.48,
18489.44,
tyhjä,
tyhjä
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
"sn":"674B1E5D",
"arvot":[
[
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",
"arvot":[
[
245,3,
6,5,
1604,
46055.7,
0,
tyhjä,
tyhjä
],
[
245,3,
6,5,
-910,
15726.73,
8956.56,
tyhjä,
tyhjä
],
[
tyhjä,
tyhjä,
tyhjä,
tyhjä,
tyhjä,
tyhjä,
tyhjä
],
[
245,3,
6,5,
-910,
15726.73,
8956.56,
tyhjä,
tyhjä
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
"sn":"3FE34ABE",
"arvot":[
[
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"
}
],
"onnistunut":true,
"viesti":null
}

Hae tunti/päivittäiset kWh-arvot invertterin tuotantoa ja verkon vaihtoa varten (sekä viedyt että tuodut)
url:https://www.iammeter.com/api/v1/site/energyhistory/?aloitusaika={2024-05-05}&loppu aika={2024-07-07}&groupby=&Token={2be6d1xxxxxxcc688}
Menetelmä: SAADA
Raja:
groupby = päivä :90 päivän tiedot (90 kpl data)
groupby = tunti :7 päivää tiedot (168 kpl data)
| nimi | Tyyppi | Des | Esimerkki | |
|---|---|---|---|---|
| Token | merkkijono | tilin tunnus | xxx | edellytetään |
| paikka_ID | määrä | paikan tunnus | edellytetään | |
| aloitusaika | merkkijono | tämän api-palautuksen alkamisaika | 2023-09-01 | edellytetään |
| loppu aika | merkkijono | tämän api:n palautuksen lopetusaika | 2023-09-07 | edellytetään |
| groupby | enum | valitse palautustietoväli (tunti/päivä) | päivä/tunti | edellytetään |
paikka_ID: Omat paikat ->Muokkaa

paikkatunnus:1360
aloitusaika=2024-05-05
endTime=2024-05-07
groupby=day
{
"tiedot": [{
"aika": "2024/5/5 0:00:00",
"tuotto": 0,
"fromGrid": 9,62,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/6 0:00:00",
"tuotto": 0,
"fromGrid": 9.16,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
}
],
"onnistunut": totta,
"viesti": tyhjä
}
paikkatunnus:2393
aloitusaika=2024-05-05
endTime=2024-05-07
groupby=day
{
"tiedot": [{
"aika": "2024/5/5 0:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/6 0:00:00",
"tuotto": 0,1,
"fromGrid": 0,22,
"toGrid": 7.15,
"erityinen lataus": 0,
"itseKäyttö": 0
}
],
"onnistunut": totta,
"viesti": tyhjä
}
paikkatunnus:2393
aloitusaika=2024-05-05
endTime=2024-05-06
groupby=tunti
{
"tiedot": [{
"aika": "2024/5/5 0:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 1:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 2:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 3:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 4:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 5:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 6:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 7:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 8:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 9:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 10:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 11:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 12:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 13:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 14:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 15:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 16:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 17:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 18:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 19:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 20:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 21:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 22:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
},
{
"aika": "2024/5/5 23:00:00",
"tuotto": 0,
"Gridistä": 0,
"toGrid": 0,
"erityinen lataus": 0,
"itseKäyttö": 0
}
],
"onnistunut": totta,
"viesti": tyhjä
}
Mitä ominaisuuksia IAMMETER tarjoaa?
Millainen sähkömittari sopii parhaiten tarpeisiisi?
Miten löydät tehomittarin tarpeidesi mukaan
Kolmivaiheinen Wi-Fi-energiamittari (WEM3080T)
Yksivaiheinen Wi-Fi-energiamittari (WEM3080)
Kolmivaiheinen Wi-Fi-energiamittari (WEM3046T)
Kolmivaiheinen Wi-Fi-energiamittari (WEM3050T)