IAMMETER-cloud nodrošina vairākus API, un izstrādātājs var izmantot šos API, lai veiktu interesantus darbus, piemēram, integrētu IAMMETER datus kādā trešās puses sistēmā. Iepriekš šos API atvērām tikai mūsu biznesa partneriem un dažiem lielajiem klientiem, bet tagad esam nolēmuši tos atvērt visiem mūsu klientiem.
Laipni lūdzam mūsu forumā dalīties ar savām domām. https://imeter.club
API nevar izmantot neierobežoti — mēs ierobežosim ikdienas izsaukumu skaitu katram API. Lūdzu, neizsauciet API biežāk, nekā noteikts.
Ja izsaukumu skaits pārsniedz stundas vai dienas ierobežojumu, API neatgriezīs neko.
| Nr. | API | Ierobežojuma veids | Stundā | Dienā | Apraksts |
|---|---|---|---|---|---|
| 1 | /user/login | ip | 5 | 30 | viena IP adrese drīkst izsaukt šo API 5 reizes stundā |
| 2 | /site/meterdata/ | SN | 12 | viens SN drīkst izsaukt šo API 12 reizes stundā | |
| 3 | /site/powerAnalysis | SN | 5 | viens SN drīkst izsaukt šo API 5 reizes dienā | |
| 4 | /site/offlineAnalysis | SN | 5 | viens SN drīkst izsaukt šo API 5 reizes dienā |
Atgriež konta tokenu. Token tiks izmantots gandrīz visos API.
Šo API nav jāizsauc, ja vien nevēlaties atsvaidzināt tokenu. Lūdzu, neizsauciet šo API vairāk nekā 5 reizes vienā stundā un ne vairāk nekā 30 reizes vienā dienā.
Iegūst konta tokenu, kas tiek izmantots visos API.
URL: https://www.iammeter.com/api/v1/user/login
Metode: post
Šo API var pārbaudīt tiešsaistē sadaļā IAMMETER SwaggerUI get token
| Nr. | Parametrs | Piezīme | Piemērs |
|---|---|---|---|
| 1 | user name | IAMMETER lietotājvārds | test |
| 2 | password | IAMMETER parole | 123456 |
Tokena vērtība tiks izmantota visos turpmāk minētajos API.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
Šo tokenu var arī nolasīt tieši pēc pieteikšanās sistēmā.
Iegūst pēdējos augšupielādētos datus ar norādīto SN.
Lūdzu, neizsauciet šo API vairāk nekā 12 reizes vienā stundā.
Basic (meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Šo API var pārbaudīt tiešsaistē sadaļā IAMMETER SwaggerUI
Advanced (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Šo API var pārbaudīt tiešsaistē sadaļā IAMMETER SwaggerUI meterdata un IAMMETER SwaggerUI meterdata2
Metode: GET
Ierobežojums: lūdzu, neizsauciet šo API vairāk nekā 288 reizes dienā (5 minūšu intervāls).
Atšķirība starp basic un advanced:
Basic: bez PF (jaudas koeficienta)
Advanced: ar PF (jaudas koeficientu)
| Nosaukums | Veids | Piemērs | |
|---|---|---|---|
| Token | String | xxx | obligāts |
| rtctime | string | 2025-6-16 | neobligāts |
Vērtību definīcija: spriegums, strāva, aktīvā jauda, importētā kWh, eksportētā 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
}
Vērtību definīcija: spriegums, strāva, aktīvā jauda, jaudas koeficients, importētā kWh, eksportētā kWh.
Lai gan apzināmies, ka jaudas koeficienta ievietošana starp aktīvo jaudu un importēto enerģiju nav optimāla, pašreizējais formāts jau ir izveidots šādā veidā — lūdzu, ņemiet vērā šo izkārtojumu
{
"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
}
Trīs masīvi values apzīmē fāzi A, fāzi B un fāzi C.
Vērtību definīcija: spriegums, strāva, aktīvā jauda, importētā kWh, eksportētā 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
}
Elementu definīcija: spriegums, strāva, aktīvā jauda, jaudas koeficients, importētā kWh, eksportētā 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 (reālā laika pulkstenis) ir arī parametrs HTTP GET pieprasījumā, kā parādīts zemāk:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
Šis pieprasījums atgriezīs augšupielādēto skaitītāja datu vērtību, kas ir vistuvāk norādītajam datumam (2025-6-16), t.i., tuvāko reģistrēto laika punktu.
Piezīme: šie API ir tādi paši kā iepriekšējā nodaļā, tikai ar dažiem papildu parametriem
Atgriež vēsturiskos datus noteiktā intervālā un laika diapazonā.
Momentānie dati tiek atjaunināti ar 1 minūtes intervālu. Dienā ir 60*24=1440 datu ierakstu. Ja pieprasāt vēsturiskos datus ar 1 minūtes intervālu, varat pieprasīt tikai 1,39 (2000/1440) dienu datus. Bet, ja pieprasāt datus ar 5 minūšu intervālu, varat pieprasīt gandrīz 7 dienu datus.
Basic (meterdatalist): https://www.iammeter.com/api/v1/site/meterdatalist/{sn}
Advanced (meterdatalist2): https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Atšķirība starp basic un advanced:
Basic: bez PF (jaudas koeficienta)
Advanced: ar PF (jaudas koeficientu)
Šo API var pārbaudīt tiešsaistē sadaļā IAMMETER SwaggerUI meterdata un IAMMETER SwaggerUI meterdata2
| Nosaukums | Veids | Piemērs | |
|---|---|---|---|
| Token | String | xxx | obligāts |
| interval | number | 300 | obligāts, mērvienība: sekunde |
| startTime | string | 2023-09-01 | obligāts |
| endTime | string | 2023-09-07 | obligāts |
Dati: [spriegums, strāva, jauda, importētā enerģija, eksportētā enerģija, UTC laiks, vietējais laiks]
{
"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
}
Atgriež jaudas analīzes rezultātu noteiktā laika periodā.
Lūdzu, neizsauciet šo API vairāk nekā 5 reizes dienā.
URL: https://www.iammeter.com/api/v1/site/powerAnalysis
Metode: get
Ierobežojums: lūdzu, neizsauciet šo API vairāk nekā 5 reizes dienā katram SN.
| Nosaukums | Veids | Piemērs | |
|---|---|---|---|
sn |
String | xxx | obligāts |
startTime |
String | 2023-09-01 | neobligāts |
endTime |
String | 2023-09-07 | neobligāts |
Piezīme:
average: vidējais jaudas rādījums šajā laika diapazonā.
averageDaytime: vidējais dienas (8:00–20:00) jaudas rādījums šajā laika diapazonā.
minimum: minimālais jaudas rādījums šajā laika diapazonā.
maximum: maksimālais jaudas rādījums šajā laika diapazonā.
{
"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
}
Atgriež pēdējo 7 dienu jaudas analīzes rezultātu.
Atgriež norādītās dienas jaudas analīzes rezultātu
Atgriež atvienošanās statusu ar norādīto SN noteiktā laika periodā.
Lūdzu, neizsauciet šo API vairāk nekā 5 reizes dienā.
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
Metode：Get
Ierobežojums: lūdzu, neizsauciet šo API vairāk nekā 5 reizes dienā katram SN.
| Nosaukums | Veids | Piemērs | |
|---|---|---|---|
sn |
String | xxxx | obligāts |
startTime |
String | 2023-09-01 | neobligāts |
endTime |
String | 2023-09-07 | neobligāts |
interval (mērvienība: minūte) |
Number | 5 | neobligāts |
Piezīme:
Šajā laika diapazonā kopumā ir 10080 minūtes.
Kopējais bezsaistes laiks šajā laika diapazonā ir 906 minūtes.
Bezsaistes pārtraukumi, kas ir garāki par 5 minūtēm, ir uzskaitīti masīvā.
{
"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
}
Atgriež norādītās dienas bezsaistes analīzes rezultātu
Atgriež jaunākās vērtības no visiem šī konta enerģijas skaitītājiem.
URL：https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Metode：Get
Ierobežojums: lūdzu, neizsauciet šo API biežāk kā reizi 5 minūtēs.
| Nosaukums | Veids | Piemērs | |
|---|---|---|---|
| Token | String | xxx | obligāts |
{
"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
}
Iegūst stundas/dienas kWh vērtības invertora saražotajai enerģijai un tīkla apmaiņai (gan eksportētajai, gan importētajai)
URL：https://www.iammeter.com/api/v1/site/energyhistory/?startTime={2024-05-05}&endTime={2024-07-07}&groupby=&Token={2be6d1xxxxxxcc688}
Metode: get
Ierobežojums：
groupby = day: 90 dienu dati (90 datu vienības)
groupby = hour: 7 dienu dati (168 datu vienības)
| Nosaukums | Veids | Apraksts | Piemērs | |
|---|---|---|---|---|
| Token | String | konta tokenas | xxx | obligāts |
| place_ID | number | vietas ID | obligāts | |
| startTime | string | šī API atgriezto datu sākuma laiks | 2023-09-01 | obligāts |
| endTime | string | šī API atgriezto datu beigu laiks | 2023-09-07 | obligāts |
| groupby | enum | atgriezto datu intervāla izvēle (stunda/diena) | day/hour | obligāts |
Place_ID: Manas vietas -> Rediģēt
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
}
What capabilities does IAMMETER offer?
Which type of electrical meter best fits your needs?
How do find the power meter with regard to your requirements
Trīsfāžu Wi-Fi enerģijas skaitītājs (WEM3080T)
Vienfāzes Wi-Fi enerģijas skaitītājs (WEM3080)
Trīsfāžu Wi-Fi enerģijas skaitītājs (WEM3046T)
Trīsfāžu Wi-Fi enerģijas skaitītājs (WEM3050T)