IAMMETER-cloud มี API บางอย่าง และนักพัฒนาสามารถใช้ API เหล่านี้เพื่อทำงานที่น่าสนใจ เช่น การผสานรวมข้อมูลของ IAMMETER เข้ากับระบบของบุคคลที่สาม ก่อนหน้านี้เราเปิด API เหล่านี้ให้เฉพาะพันธมิตรทางธุรกิจและลูกค้ารายใหญ่บางรายเท่านั้น แต่ตอนนี้เราได้ตัดสินใจเปิดให้ลูกค้าทุกคนใช้งานแล้ว
ยินดีต้อนรับให้แจ้งให้เราทราบความคิดเห็นของคุณบนฟอรัมของเรา https://imeter.club
ไม่สามารถเรียกใช้ API ได้อย่างไม่จำกัด เราจะจำกัดจำนวนการเรียกในแต่ละวันสำหรับแต่ละ API โปรดอย่าเรียก API บ่อยเกินไป
หากจำนวนการเรียกเกินขีดจำกัดรายชั่วโมงหรือรายวัน API จะไม่ส่งคืนสิ่งใด
| No. | API | ประเภทการจำกัด | รายชั่วโมง | รายวัน | คำอธิบาย |
|---|---|---|---|---|---|
| 1 | /user/login | ip | 5 | 30 | หนึ่ง IP จะได้รับอนุญาตให้เรียก API นี้ 5 ครั้งต่อชั่วโมง |
| 2 | /site/meterdata/ | SN | 12 | หนึ่ง SN จะได้รับอนุญาตให้เรียก API นี้ 12 ครั้งต่อชั่วโมง | |
| 3 | /site/powerAnalysis | SN | 5 | หนึ่ง SN จะได้รับอนุญาตให้เรียก API นี้ 5 ครั้งต่อวัน | |
| 4 | /site/offlineAnalysis | SN | 5 | หนึ่ง SN จะได้รับอนุญาตให้เรียก API นี้ 5 ครั้งต่อวัน |
ส่งคืนโทเค็นของบัญชี โทเค็นจะถูกใช้ใน API เกือบทั้งหมด
คุณไม่จำเป็นต้องเรียก API นี้เว้นแต่คุณต้องการรีเฟรชโทเค็น โปรดอย่าเรียก API นี้เกิน 5 ครั้งในหนึ่งชั่วโมง และไม่เกิน 30 ครั้งในหนึ่งวัน
รับโทเค็นของบัญชีซึ่งใช้ใน API ทั้งหมด
URL: https://www.iammeter.com/api/v1/user/login
Method: post
API นี้สามารถทดสอบออนไลน์ได้ที่ IAMMETER SwaggerUI รับโทเค็น
| No. | พารามิเตอร์ | หมายเหตุ | ตัวอย่าง |
|---|---|---|---|
| 1 | user name | ชื่อผู้ใช้ IAMMETER | test |
| 2 | password | รหัสผ่านของ IAMMETER | 123456 |
ค่าโทเค็นจะถูกใช้ใน API ทั้งหมดด้านล่าง
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
โทเค็นนี้สามารถอ่านได้โดยตรงหลังจากที่คุณเข้าสู่ระบบ
รับข้อมูลอัปโหลดล่าสุดตาม SN ที่ระบุ
โปรดอย่าเรียก API นี้เกิน 12 ครั้งในหนึ่งชั่วโมง
Basic (meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
API นี้สามารถทดสอบออนไลน์ได้ที่ IAMMETER SwaggerUI
Advanced (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
API นี้สามารถทดสอบออนไลน์ได้ที่ IAMMETER SwaggerUI meterdata และ IAMMETER SwaggerUI meterdata2
Method: GET
ข้อจำกัด: โปรดอย่าส่งคำขอไปยัง API นี้เกิน 288 ครั้งต่อวัน (ช่วงเวลา 5 นาที)
ความแตกต่างระหว่าง basic และ advanced:
Basic: ไม่มี PF (Power factor)
Advanced: มี PF (Power factor)
| Name | Type | Example | |
|---|---|---|---|
| Token | String | xxx | required |
| rtctime | string | 2025-6-16 | optional |
นิยามค่า: 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
}
นิยามค่า: voltage, current, active power, power factor, imported kWh, exported kWh
แม้ว่าเราจะตระหนักว่าการวาง power factor ไว้ระหว่าง active power และ imported energy นั้นไม่เหมาะสมที่สุด แต่รูปแบบปัจจุบันได้ถูกกำหนดไว้แล้ว—โปรดทราบถึงการจัดเรียงนี้
{
"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 แสดงถึง Phase A, Phase B และ Phase C
นิยามค่า: 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
}
นิยามองค์ประกอบ: 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) เป็นพารามิเตอร์หนึ่งในคำขอ HTTP GET ด้วย ดังแสดงด้านล่าง:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
คำขอนี้จะส่งคืนค่าข้อมูลมิเตอร์ที่อัปโหลดใกล้กับวันที่ที่ระบุมากที่สุด (2025-6-16) ซึ่งหมายถึงจุดเวลาที่บันทึกไว้ใกล้เคียงที่สุด
หมายเหตุ: API เหล่านี้เหมือนกับบทที่แล้ว เพิ่มพารามิเตอร์บางอย่างเท่านั้น
ส่งคืนข้อมูลประวัติตามช่วงเวลาและช่วงวันที่ที่ตั้งไว้
ข้อมูลทันทีมีช่วงเวลา 1 นาที มีข้อมูล 60*24=1440 รายการต่อวัน หากคุณขอข้อมูลประวัติในช่วงเวลา 1 นาที คุณสามารถขอข้อมูลได้เพียง 1.39 (2000/1440) วัน แต่ถ้าคุณขอข้อมูลในช่วงเวลา 5 นาที คุณสามารถขอข้อมูลได้เกือบ 7 วัน
Basic (meterdatalist): https://www.iammeter.com/api/v1/site/meterdatalist/{sn}
Advanced (meterdatalist2): https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
ความแตกต่างระหว่าง basic และ advanced:
Basic: ไม่มี PF (Power factor)
Advanced: มี PF (Power factor)
API นี้สามารถทดสอบออนไลน์ได้ที่ IAMMETER SwaggerUI meterdata และ IAMMETER SwaggerUI meterdata2
| Name | Type | Example | |
|---|---|---|---|
| Token | String | xxx | required |
| interval | number | 300 | required, unit: second |
| startTime | string | 2023-09-01 | required |
| endTime | string | 2023-09-07 | required |
ข้อมูล: [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
}
ส่งคืนผลการวิเคราะห์กำลังไฟฟ้าในช่วงเวลาที่ระบุ
โปรดอย่าเรียก API นี้เกิน 5 ครั้งในหนึ่งวัน
URL: https://www.iammeter.com/api/v1/site/powerAnalysis
Method: get
ข้อจำกัด: โปรดอย่าส่งคำขอไปยัง API นี้ต่อ SN เกิน 5 ครั้งต่อวัน
| Name | Type | Example | |
|---|---|---|---|
sn |
String | xxx | required |
startTime |
String | 2023-09-01 | optional |
endTime |
String | 2023-09-07 | optional |
หมายเหตุ:
average: ค่ากำลังไฟฟ้าเฉลี่ยในช่วงเวลานี้
averageDaytime: ค่ากำลังไฟฟ้าเฉลี่ยในช่วงกลางวัน (8:00 น. - 20:00 น.) ในช่วงเวลานี้
minimum: ค่ากำลังไฟฟ้าต่ำสุดในช่วงเวลานี้
maximum: ค่ากำลังไฟฟ้าสูงสุดในช่วงเวลานี้
{
"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
}
ส่งคืนผลการวิเคราะห์กำลังไฟฟ้าของ 7 วันที่ผ่านมา
ส่งคืนผลการวิเคราะห์กำลังไฟฟ้าของวันที่ระบุ
ส่งคืนสถานะการตัดการเชื่อมต่อตาม SN ที่ระบุในช่วงเวลาที่กำหนด
โปรดอย่าเรียก API นี้เกิน 5 ครั้งในหนึ่งวัน
URL: https://www.iammeter.com/api/v1/site/offlineAnalysis
Method: Get
ข้อจำกัด: โปรดอย่าส่งคำขอไปยัง API นี้ต่อ SN เกิน 5 ครั้งต่อวัน
| Name | Type | Example | |
|---|---|---|---|
sn |
String | xxxx | required |
startTime |
String | 2023-09-01 | optional |
endTime |
String | 2023-09-07 | optional |
interval (หน่วย: นาที) |
Number | 5 | optional |
หมายเหตุ:
มีทั้งหมด 10080 นาทีในช่วงเวลานี้
เวลาออฟไลน์ทั้งหมดคือ 906 นาทีในช่วงเวลานี้
ช่วงเวลาออฟไลน์ที่มากกว่า 5 นาทีจะแสดงอยู่ในอาร์เรย์
{
"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
}
ส่งคืนผลการวิเคราะห์ออฟไลน์ของวันที่ระบุ
ส่งคืนค่าล่าสุดของมิเตอร์พลังงานทั้งหมดในบัญชีนี้
URL: https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Method: Get
ข้อจำกัด: โปรดตรวจสอบให้แน่ใจว่าคุณไม่ได้ส่งคำขอไปยัง API นี้บ่อยเกินกว่าหนึ่งครั้งทุก 5 นาที
| Name | Type | Example | |
|---|---|---|---|
| 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
}
ดึงค่ากิโลวัตต์ชั่วโมงรายชั่วโมง/รายวันสำหรับการผลิตจากอินเวอร์เตอร์และการแลกเปลี่ยนกับโครงข่ายไฟฟ้า (ทั้งที่ส่งออกและนำเข้า)
Method: get
ข้อจำกัด:
groupby = day: ข้อมูล 90 วัน (90 รายการ)
groupby = hour: ข้อมูล 7 วัน (168 รายการ)
| Name | Type | คำอธิบาย | ตัวอย่าง | |
|---|---|---|---|---|
| Token | String | โทเค็นของบัญชี | xxx | required |
| place_ID | number | ID ของสถานที่ | required | |
| startTime | string | เวลาเริ่มต้นที่ API นี้จะส่งคืน | 2023-09-01 | required |
| endTime | string | เวลาสิ้นสุดที่ API นี้จะส่งคืน | 2023-09-07 | required |
| groupby | enum | เลือกช่วงข้อมูลที่ส่งคืน (hour/day) | day/hour | required |
Place_ID: My Places -> แก้ไข
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
}
IAMMETER มีความสามารถอะไรบ้าง?
มิเตอร์ไฟฟ้าชนิดใดที่เหมาะกับความต้องการของคุณมากที่สุด?
วิธีค้นหามิเตอร์พลังงานที่ตรงกับความต้องการของคุณ
มิเตอร์พลังงาน Wi-Fi สามเฟส (WEM3080T)
มิเตอร์พลังงาน Wi-Fi เฟสเดียว (WEM3080)
มิเตอร์พลังงาน Wi-Fi สามเฟส (WEM3046T)
มิเตอร์พลังงาน Wi-Fi สามเฟส (WEM3050T)