IAMMETER-cloud menyediakan sejumlah API, dan pengembang dapat menggunakan API ini untuk melakukan hal-hal menarik, seperti mengintegrasikan data IAMMETER ke dalam sistem pihak ketiga. Sebelumnya kami hanya membuka API ini untuk mitra bisnis dan beberapa pelanggan besar, tetapi sekarang kami memutuskan untuk membukanya bagi semua pelanggan kami.
Silakan sampaikan pendapat Anda kepada kami di forum kami. https://imeter.club
API tidak dapat diakses tanpa batas, kami akan membatasi jumlah pemanggilan harian untuk setiap API. Mohon jangan memanggil API terlalu sering.
Jika jumlah pemanggilan melebihi batas per jam atau harian, API tidak akan mengembalikan apa pun.
| No. | API | jenis batas | per jam | Harian | deskripsi |
|---|---|---|---|---|---|
| 1 | /user/login | ip | 5 | 30 | satu IP hanya diizinkan memanggil API ini 5 kali per jam |
| 2 | /site/meterdata/ | SN | 12 | satu SN hanya diizinkan memanggil API ini 12 kali per jam | |
| 3 | /site/powerAnalysis | SN | 5 | satu SN hanya diizinkan memanggil API ini 5 kali per hari | |
| 4 | /site/offlineAnalysis | SN | 5 | satu SN hanya diizinkan memanggil API ini 5 kali per hari |
Kembalikan token akun. Token ini akan digunakan di hampir semua API.
Anda tidak perlu memanggil API ini kecuali Anda ingin menyegarkan (refresh) token. Mohon jangan memanggil API ini lebih dari 5 kali dalam satu jam, dan tidak lebih dari 30 kali dalam satu hari.
Dapatkan token akun yang digunakan di semua API.
URL: https://www.iammeter.com/api/v1/user/login
Metode: post
API ini dapat diuji secara online di IAMMETER SwaggerUI get token
| No. | parameter | keterangan | contoh |
|---|---|---|---|
| 1 | user name | Nama pengguna IAMMETER | test |
| 2 | password | kata sandi IAMMETER | 123456 |
Nilai token akan digunakan di semua API di bawah ini.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
Token ini juga dapat dibaca langsung setelah Anda masuk ke sistem.
Dapatkan data unggahan terakhir dengan SN terkait.
Mohon jangan memanggil API ini lebih dari 12 kali dalam satu jam.
Basic (meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
API ini dapat diuji secara online di IAMMETER SwaggerUI
Advanced (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
API ini dapat diuji secara online di IAMMETER SwaggerUI meterdata dan IAMMETER SwaggerUI meterdata2
Metode: GET
Batasan: mohon jangan meminta API ini lebih dari 288 kali setiap hari (interval 5 menit).
Perbedaan antara basic dan advanced:
Basic: tanpa PF (Power factor)
Advanced: dengan PF (Power factor)
| Nama | Tipe | Contoh | |
|---|---|---|---|
| Token | String | xxx | required |
| rtctime | string | 2025-6-16 | optional |
definisi nilai: 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
}
definisi nilai: voltage, current, active power, power factor, imported kWh, exported kWh.
Meskipun kami menyadari bahwa menempatkan power factor di antara active power dan imported energy bukanlah hal yang ideal, format saat ini sudah disusun seperti itu—mohon perhatikan susunan ini
{
"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
}
Tiga array di dalam values mewakili Fase A, fase B, dan Fase C.
definisi nilai: 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
}
Definisi elemen: 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) juga merupakan parameter dalam permintaan HTTP GET, seperti yang ditunjukkan di bawah ini:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
Permintaan ini akan mengembalikan nilai data meter yang diunggah paling dekat dengan tanggal yang ditentukan (2025-6-16), yaitu titik waktu terekam yang paling dekat.
Catatan: API ini sama seperti bab sebelumnya, hanya ditambah beberapa parameter
Kembalikan data historis pada interval dan rentang waktu yang ditentukan.
Data instan berinterval 1 menit. Ada 60*24=1440 buah data per hari. Jika Anda meminta data historis dengan interval 1 menit, Anda hanya dapat meminta data selama 1,39 (2000/1440) hari. Namun jika Anda meminta data dengan interval 5 menit, Anda dapat meminta data hampir 7 hari.
Basic (meterdatalist): https://www.iammeter.com/api/v1/site/meterdatalist/{sn}
Advanced (meterdatalist2): https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Perbedaan antara basic dan advanced:
Basic: tanpa PF (Power factor)
Advanced: dengan PF (Power factor)
API ini dapat diuji secara online di IAMMETER SwaggerUI meterdata dan IAMMETER SwaggerUI meterdata2
| Nama | Tipe | Contoh | |
|---|---|---|---|
| Token | String | xxx | required |
| interval | number | 300 | required, satuan: detik |
| startTime | string | 2023-09-01 | required |
| endTime | string | 2023-09-07 | required |
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":[
{ //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
}
Kembalikan hasil analisis daya pada waktu yang ditentukan.
Mohon jangan memanggil API ini lebih dari 5 kali dalam satu hari.
URL: https://www.iammeter.com/api/v1/site/powerAnalysis
Metode: get
Batasan: Mohon jangan meminta API ini per SN lebih dari 5 kali setiap hari.
| Nama | Tipe | Contoh | |
|---|---|---|---|
sn |
String | xxx | required |
startTime |
String | 2023-09-01 | optional |
endTime |
String | 2023-09-07 | optional |
Catatan:
average: rata-rata pembacaan daya selama rentang waktu ini.
averageDaytime: rata-rata pembacaan daya pada siang hari (08.00-20.00) selama rentang waktu ini.
minimum: pembacaan daya minimum selama rentang waktu ini.
maximum: pembacaan daya maksimum selama rentang waktu ini.
{
"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
}
Mengembalikan hasil analisis daya 7 hari terakhir.
Mengembalikan hasil analisis daya pada hari yang ditentukan
Kembalikan status pemutusan koneksi dengan SN terkait pada waktu yang ditentukan.
Mohon jangan memanggil API ini lebih dari 5 kali dalam satu hari.
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
Metode：Get
Batasan: Mohon jangan meminta API ini per SN lebih dari 5 kali setiap hari.
| Nama | Tipe | Contoh | |
|---|---|---|---|
sn |
String | xxxx | required |
startTime |
String | 2023-09-01 | optional |
endTime |
String | 2023-09-07 | optional |
interval (satuan: menit) |
Number | 5 | optional |
Catatan:
Total ada 10080 menit dalam rentang waktu ini.
Total waktu offline adalah 906 menit dalam rentang waktu ini.
Jeda offline yang lebih besar dari 5 menit dicantumkan dalam 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
}
Mengembalikan hasil analisis offline pada hari yang ditentukan
Kembalikan nilai terbaru dari semua meter energi di akun ini.
URL：https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Metode：Get
Batasan: Mohon pastikan Anda tidak mengirim permintaan ke API ini lebih sering daripada sekali setiap 5 menit.
| Nama | Tipe | Contoh | |
|---|---|---|---|
| Token | String | xxx | required |
{
"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
}
Ambil nilai kWh per jam/harian untuk pembangkitan inverter dan pertukaran dengan grid (baik yang diekspor maupun diimpor)
URL：https://www.iammeter.com/api/v1/site/energyhistory/?startTime={2024-05-05}&endTime={2024-07-07}&groupby=&Token={2be6d1xxxxxxcc688}
Metode: get
Batasan：
groupby = day : data 90 hari (90 buah data)
groupby = hour : data 7 hari (168 buah data)
| Nama | Tipe | Keterangan | Contoh | |
|---|---|---|---|---|
| Token | String | token akun | xxx | required |
| place_ID | number | ID lokasi | required | |
| startTime | string | waktu mulai data yang dikembalikan API ini | 2023-09-01 | required |
| endTime | string | waktu berakhir data yang dikembalikan API ini | 2023-09-07 | required |
| groupby | enum | pilih interval data yang dikembalikan (jam/hari) | day/hour | required |
Place_ID: My Places->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
}
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
Meter energi Wi-Fi tiga fase (WEM3080T)
Meter energi Wi-Fi satu fase (WEM3080)
Meter energi Wi-Fi tiga fase (WEM3046T)
Meter energi Wi-Fi tiga fase (WEM3050T)