IAMMETER-cloud biedt enkele API's aan, en de ontwikkelaar kan deze API's gebruiken om interessante taken uit te voeren, zoals het integreren van de gegevens van IAMMETER in een extern systeem. We hebben deze API's voorheen alleen opengesteld voor onze zakelijke partners en enkele grote klanten, maar hebben besloten ze nu voor al onze klanten beschikbaar te maken.
Laat ons weten wat u ervan vindt op ons forum. https://imeter.club
De API kan niet onbeperkt worden gebruikt, we beperken het aantal dagelijkse aanroepen voor elke API. Roep de API niet te vaak aan.
Als het aantal aanroepen de uurlijkse of dagelijkse limiet overschrijdt, retourneert de API niets.
| Nr. | API | limiettype | per uur | Dagelijks | beschrijving |
|---|---|---|---|---|---|
| 1 | /user/login | ip | 5 | 30 | één IP mag deze API maximaal 5 keer per uur aanroepen |
| 2 | /site/meterdata/ | SN | 12 | één SN mag deze API maximaal 12 keer per uur aanroepen | |
| 3 | /site/powerAnalysis | SN | 5 | één SN mag deze API maximaal 5 keer per dag aanroepen | |
| 4 | /site/offlineAnalysis | SN | 5 | één SN mag deze API maximaal 5 keer per dag aanroepen |
Retourneert het token van het account. Het token wordt gebruikt in bijna alle API's.
U hoeft deze API niet aan te roepen, tenzij u het token wilt verversen. Roep deze API niet vaker dan 5 keer per uur aan, en niet vaker dan 30 keer per dag.
Haal het token van het account op dat in alle API's wordt gebruikt.
URL: https://www.iammeter.com/api/v1/user/login
Methode: post
Deze API kan online worden getest in IAMMETER SwaggerUI token ophalen
| Nr. | parameter | opmerking | voorbeeld |
|---|---|---|---|
| 1 | user name | Gebruikersnaam van IAMMETER | test |
| 2 | password | Wachtwoord van IAMMETER | 123456 |
De tokenwaarde wordt gebruikt in alle onderstaande API's.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
Dit token kan ook rechtstreeks worden uitgelezen nadat u in het systeem bent ingelogd.
Haal de laatste uploadgegevens op met het bijbehorende SN.
Roep deze API niet vaker dan 12 keer per uur aan.
Basis (meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Deze API kan online worden getest in IAMMETER SwaggerUI
Geavanceerd (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Deze API kan online worden getest in IAMMETER SwaggerUI meterdata en IAMMETER SwaggerUI meterdata2
Methode: GET
Limiet: vraag deze API niet meer dan 288 keer per dag aan (interval van 5 minuten).
Het verschil tussen basis en geavanceerd:
Basis: zonder PF (Power factor)
Geavanceerd: met PF (Power factor)
| Naam | Type | Voorbeeld | |
|---|---|---|---|
| Token | String | xxx | verplicht |
| rtctime | string | 2025-6-16 | optioneel |
waarden definitie: voltage, current, active power, imported kWh, exported kWh
{
"data": {
"values": [
[
230.220, //voltage
1.300, //current
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
}
waarden definitie: voltage, current, active power, power factor, imported kWh, exported kWh.
Hoewel we erkennen dat het plaatsen van de power factor tussen actief vermogen en geïmporteerde energie niet optimaal is, is de huidige indeling eenmaal zo ingesteld—houd hiermee rekening.
{
"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
}
De drie arrays in values vertegenwoordigen fase A, fase B en fase C.
waarden definitie: 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
}
Elementdefinitie: 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
}
De RTC (Real-Time Clock) is ook een parameter in de HTTP GET-aanvraag, zoals hieronder weergegeven:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
Dit verzoek retourneert de dichtstbijzijnde meetwaarde bij de opgegeven datum (2025-6-16).
Opmerking: deze API's zijn hetzelfde als in het vorige hoofdstuk, alleen met enkele extra parameters
Retourneert de historische gegevens op het ingestelde interval en tijdsbereik.
De momentane gegevens hebben een interval van 1 minuut. Er zijn 60*24=1440 gegevens per dag. Als u de historische gegevens met een interval van 1 minuut opvraagt, kunt u slechts gegevens van 1,39 (2000/1440) dag opvragen. Maar als u de gegevens met een interval van 5 minuten opvraagt, kunt u bijna 7 dagen aan gegevens opvragen.
Basis (meterdatalist): https://www.iammeter.com/api/v1/site/meterdatalist/{sn}
Geavanceerd (meterdatalist2): https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Het verschil tussen basis en geavanceerd:
Basis: zonder PF (Power factor)
Geavanceerd: met PF (Power factor)
Deze API kan online worden getest in IAMMETER SwaggerUI meterdata en IAMMETER SwaggerUI meterdata2
| Naam | Type | Voorbeeld | |
|---|---|---|---|
| Token | String | xxx | verplicht |
| interval | number | 300 | verplicht, eenheid: seconden |
| startTime | string | 2023-09-01 | verplicht |
| endTime | string | 2023-09-07 | verplicht |
Data: [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":[
{ //eerste 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
]
]
},
{ //tweede 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
]
]
},
{ //derde 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
}
Retourneert het vermogensanalyse-resultaat over de opgegeven periode.
Roep deze API niet vaker dan 5 keer per dag aan.
URL: https://www.iammeter.com/api/v1/site/powerAnalysis
Methode: get
Limiet: vraag deze API per SN niet meer dan 5 keer per dag aan.
| Naam | Type | Voorbeeld | |
|---|---|---|---|
sn |
String | xxx | verplicht |
startTime |
String | 2023-09-01 | optioneel |
endTime |
String | 2023-09-07 | optioneel |
Opmerking:
average: gemiddeld vermogen over dit tijdsbereik.
averageDaytime: gemiddeld vermogen overdag (8:00-20:00 uur) over dit tijdsbereik.
minimum: minimaal vermogen over dit tijdsbereik.
maximum: maximaal vermogen over dit tijdsbereik.
{
"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
}
Het vermogensanalyse-resultaat van de laatste 7 dagen retourneren.
Het vermogensanalyse-resultaat van een opgegeven dag retourneren
Retourneert de verbindingsstatus van het opgegeven SN over de opgegeven periode.
Roep deze API niet vaker dan 5 keer per dag aan.
URL: https://www.iammeter.com/api/v1/site/offlineAnalysis
Methode: Get
Limiet: vraag deze API per SN niet meer dan 5 keer per dag aan.
| Naam | Type | Voorbeeld | |
|---|---|---|---|
sn |
String | xxxx | verplicht |
startTime |
String | 2023-09-01 | optioneel |
endTime |
String | 2023-09-07 | optioneel |
interval (eenheid: minuut) |
Number | 5 | optioneel |
Opmerking:
Er zijn in totaal 10080 minuten in dit tijdsbereik.
De totale offline-tijd is 906 minuten in dit tijdsbereik.
De offline-onderbrekingen die langer zijn dan 5 minuten worden weergegeven in de 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
}
Het offline-analyse resultaat van een opgegeven dag retourneren
Retourneert de nieuwste waarde van alle energiemeters in dit account.
URL: https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Methode: Get
Limiet: zorg ervoor dat u deze API niet vaker dan eens per 5 minuten aanroept.
| Naam | Type | Voorbeeld | |
|---|---|---|---|
| Token | String | xxx | verplicht |
{
"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
}
Haal de uurlijkse/dagelijkse kWh-waarden op voor omvormeropbrengst en netuitwisseling (zowel geëxporteerd als geïmporteerd).
Methode: get
Limiet:
groupby = day: 90 dagen gegevens (90 stuks gegevens)
groupby = hour: 7 dagen gegevens (168 stuks gegevens)
| Naam | Type | Beschrijving | Voorbeeld | |
|---|---|---|---|---|
| Token | String | token van het account | xxx | verplicht |
| place_ID | number | ID van de plaats | verplicht | |
| startTime | string | starttijd van deze API-retour | 2023-09-01 | verplicht |
| endTime | string | stoptijd van deze API-retour | 2023-09-07 | verplicht |
| groupby | enum | selecteer retourinterval (uur/dag) | day/hour | verplicht |
place_ID: Mijn Plaatsen -> Bewerken
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.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
}
Welke mogelijkheden biedt IAMMETER?
Welk type elektriciteitsmeter past het beste bij uw behoeften?
Hoe vindt u de juiste vermogensmeter voor uw vereisten
Driefasige Wi-Fi-energiemeter (WEM3080T)
Eenfasige Wi-Fi-energiemeter (WEM3080)
Driefasige Wi-Fi-energiemeter (WEM3046T)
Driefasige Wi-Fi-energiemeter (WEM3050T)