IAMMETER-cloud cung cấp một số API, và nhà phát triển có thể dùng những API này để làm những việc thú vị, chẳng hạn như tích hợp dữ liệu của IAMMETER vào một hệ thống của bên thứ ba. Trước đây chúng tôi chỉ mở những API này cho các đối tác kinh doanh và một số khách hàng lớn, nhưng nay đã quyết định mở cho toàn bộ khách hàng của mình.
Hãy cho chúng tôi biết suy nghĩ của bạn trên diễn đàn của chúng tôi. https://imeter.club
API không thể được truy cập không giới hạn, chúng tôi sẽ giới hạn số lần gọi mỗi ngày cho từng API. Xin đừng gọi API với tần suất quá dày.
Nếu số lần gọi vượt quá giới hạn theo giờ hoặc theo ngày, API sẽ không trả về gì cả.
| No. | API | loại giới hạn | mỗi giờ | mỗi ngày | mô tả |
|---|---|---|---|---|---|
| 1 | /user/login | ip | 5 | 30 | một IP chỉ được phép gọi API này 5 lần mỗi giờ |
| 2 | /site/meterdata/ | SN | 12 | một SN chỉ được phép gọi API này 12 lần mỗi giờ | |
| 3 | /site/powerAnalysis | SN | 5 | một SN chỉ được phép gọi API này 5 lần mỗi ngày | |
| 4 | /site/offlineAnalysis | SN | 5 | một SN chỉ được phép gọi API này 5 lần mỗi ngày |
Trả về token của tài khoản. Token này sẽ được dùng trong gần như toàn bộ các API.
Bạn không cần gọi API này trừ khi bạn muốn làm mới token. Xin đừng gọi API này quá 5 lần trong một giờ, và không quá 30 lần trong một ngày.
Lấy token của tài khoản, token này được dùng trong tất cả các API.
URL: https://www.iammeter.com/api/v1/user/login
Method: post
API này có thể được kiểm thử trực tuyến tại IAMMETER SwaggerUI get token
| No. | tham số | ghi chú | ví dụ |
|---|---|---|---|
| 1 | user name | Tên người dùng của IAMMETER | test |
| 2 | password | mật khẩu của IAMMETER | 123456 |
Giá trị token sẽ được dùng trong tất cả các API bên dưới.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
Token này cũng có thể được đọc trực tiếp sau khi bạn đăng nhập vào hệ thống.
Lấy dữ liệu tải lên mới nhất của SN tương ứng.
Xin đừng gọi API này quá 12 lần trong một giờ.
Basic (meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
API này có thể được kiểm thử trực tuyến tại IAMMETER SwaggerUI
Advanced (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
API này có thể được kiểm thử trực tuyến tại IAMMETER SwaggerUI meterdata và IAMMETER SwaggerUI meterdata2
Method: GET
Limit: xin đừng yêu cầu API này quá 288 lần mỗi ngày (khoảng cách 5 phút).
Sự khác biệt giữa basic và advanced:
Basic: không có PF (hệ số công suất)
Advanced: có PF (hệ số công suất)
| Tên | Kiểu | Ví dụ | |
|---|---|---|---|
| Token | String | xxx | bắt buộc |
| rtctime | string | 2025-6-16 | tùy chọn |
định nghĩa các giá trị: điện áp, dòng điện, công suất tác dụng, điện năng nhập (kWh), điện năng phát (kWh)
{
"data": {
"values": [
[
230.220, //điện áp
1.300, //dòng điện
119.000,//công suất tác dụng
1766.590, //điện năng nhập (kWh)
0.000 //điện năng phát (kWh)
]
],
"localTime": "2020/8/28 15:27:33",
"gmtTime": "2020/8/28 5:27:33"
},
"successful": true,
"message": null
}
định nghĩa các giá trị: điện áp, dòng điện, công suất tác dụng, hệ số công suất, điện năng nhập (kWh), điện năng phát (kWh).
Chúng tôi nhận thấy rằng việc đặt hệ số công suất giữa công suất tác dụng và điện năng nhập là chưa tối ưu, nhưng định dạng hiện tại đã được thiết lập như vậy — xin hãy lưu ý về cách sắp xếp này
{
"data":{
"values":[
[
233.41, //điện áp
0.718,//dòng điện
111,//công suất tác dụng
0.66,//hệ số công suất
5724.85, //điện năng nhập
0 //điện năng phát
]
],
"localTime":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"successful":true,
"message":null
}
Ba mảng trong values đại diện cho Pha A, Pha B và Pha C.
định nghĩa các giá trị: điện áp, dòng điện, công suất tác dụng, điện năng nhập (kWh), điện năng phát (kWh)
{
"data": {
"values": [
[
242.600,//điện áp
1.000,//dòng điện
216.000,//công suất tác dụng
32354.600,//điện năng nhập
0.000//điện năng phát
],
[
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
}
định nghĩa các phần tử: điện áp, dòng điện, công suất tác dụng, hệ số công suất, điện năng nhập (kWh), điện năng phát (kWh)
{
"data":{
"values":[
[//pha A
233.8,//điện áp
0.03,//dòng điện
4,//công suất tác dụng
0.57,//hệ số công suất
222.53,//điện năng nhập (kWh)
0 //điện năng phát (kWh)
],
[//pha B
5,
0,
0,
0,
0,
0
],
[ //pha 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 - đồng hồ thời gian thực) cũng là một tham số trong yêu cầu HTTP GET, như minh họa bên dưới:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
Yêu cầu này sẽ trả về giá trị dữ liệu đồng hồ đã tải lên gần nhất so với ngày được chỉ định (2025-6-16), tức thời điểm được ghi nhận gần nhất.
Lưu ý: các API này giống như chương trước, chỉ thêm một số tham số
Trả về dữ liệu lịch sử theo khoảng thời gian và phạm vi thời gian đã đặt.
Dữ liệu tức thời có khoảng cách 1 phút. Mỗi ngày có 60*24=1440 bản ghi. Nếu bạn yêu cầu dữ liệu lịch sử với khoảng cách 1 phút, bạn chỉ có thể yêu cầu dữ liệu của 1.39 (2000/1440) ngày. Nhưng nếu bạn yêu cầu dữ liệu với khoảng cách 5 phút, bạn có thể yêu cầu dữ liệu của gần 7 ngày.
Basic (meterdatalist):https://www.iammeter.com/api/v1/site/meterdatalist/
**Advanced (meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Sự khác biệt giữa basic và advanced:
Basic: không có PF (hệ số công suất)
Advanced: có PF (hệ số công suất)
API này có thể được kiểm thử trực tuyến tại IAMMETER SwaggerUI meterdata và IAMMETER SwaggerUI meterdata2
| Tên | Kiểu | Ví dụ | |
|---|---|---|---|
| Token | String | xxx | bắt buộc |
| interval | number | 300 | bắt buộc, đơn vị: giây |
| startTime | string | 2023-09-01 | bắt buộc |
| endTime | string | 2023-09-07 | bắt buộc |
Data: [điện áp, dòng điện, công suất, điện năng nhập, điện năng phát, thời gian utc, thời gian local]
{
"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,//điện áp pha A
0,//dòng điện
0,//công suất tác dụng
468.41,//điện năng nhập (kWh)
0,//điện năng phát (kWh)
230,//pha B
0,
0,
236.58,
290.77,
230,//pha 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":[
{ //dữ liệu thứ nhất
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"values":[
[ //pha A
235.2,//điện áp
0.03,//dòng điện
4,//công suất tác dụng
0.57,//hệ số công suất
210.21,//điện năng nhập (kWh)
0 //điện năng phát (kWh)
],
[//pha B
5.5,
0,
0,
0,
0,
0
],
[ //pha C
3.3,
0,
0,
0,
0,
0
]
]
},
{ //dữ liệu thứ hai
"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
]
]
},
{ //dữ liệu thứ ba
"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
}
Trả về kết quả phân tích công suất trong khoảng thời gian được chỉ định.
Xin đừng gọi API này quá 5 lần trong một ngày.
URL:https://www.iammeter.com/api/v1/site/powerAnalysis
Method: get
Limit: Xin đừng yêu cầu API này cho mỗi SN quá 5 lần mỗi ngày.
| Tên | Kiểu | Ví dụ | |
|---|---|---|---|
sn |
String | xxx | bắt buộc |
startTime |
String | 2023-09-01 | tùy chọn |
endTime |
String | 2023-09-07 | tùy chọn |
Lưu ý:
average: chỉ số công suất trung bình trong khoảng thời gian này.
averageDaytime: chỉ số công suất trung bình vào ban ngày (8:00 - 20:00) trong khoảng thời gian này.
minimum: chỉ số công suất nhỏ nhất trong khoảng thời gian này.
maximum: chỉ số công suất lớn nhất trong khoảng thời gian này.
{
"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
}
Trả về kết quả phân tích công suất của 7 ngày gần nhất.
Trả về kết quả phân tích công suất của ngày được chỉ định
Trả về trạng thái mất kết nối của SN tương ứng trong khoảng thời gian được chỉ định.
Xin đừng gọi API này quá 5 lần trong một ngày.
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
Method：Get
Limit: Xin đừng yêu cầu API này cho mỗi SN quá 5 lần mỗi ngày.
| Tên | Kiểu | Ví dụ | |
|---|---|---|---|
sn |
String | xxxx | bắt buộc |
startTime |
String | 2023-09-01 | tùy chọn |
endTime |
String | 2023-09-07 | tùy chọn |
interval(đơn vị: phút) |
Number | 5 | tùy chọn |
Lưu ý:
Tổng cộng có 10080 phút trong khoảng thời gian này.
Tổng thời gian ngoại tuyến là 906 phút trong khoảng thời gian này.
Khoảng ngoại tuyến lớn hơn 5 phút được liệt kê trong mảng.
{
"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
}
Trả về kết quả phân tích ngoại tuyến của ngày được chỉ định
Trả về giá trị mới nhất của tất cả đồng hồ đo điện trong tài khoản này.
URL：https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Method：Get
Limit: Xin đảm bảo rằng bạn không gửi yêu cầu tới API này với tần suất dày hơn một lần mỗi 5 phút.
| Tên | Kiểu | Ví dụ | |
|---|---|---|---|
| Token | String | xxx | bắt buộc |
{
"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
}
Lấy giá trị kWh theo giờ/ngày cho điện năng phát của inverter và trao đổi với lưới điện (cả phát lên lưới và nhận từ lưới)
URL：https://www.iammeter.com/api/v1/site/energyhistory/?startTime={2024-05-05}&endTime={2024-07-07}&groupby=&Token={2be6d1xxxxxxcc688}
Method: get
Limit：
groupby = day : dữ liệu 90 ngày (90 bản ghi)
groupby = hour : dữ liệu 7 ngày (168 bản ghi)
| Tên | Kiểu | Mô tả | Ví dụ | |
|---|---|---|---|---|
| Token | String | token của tài khoản | xxx | bắt buộc |
| place_ID | number | ID của địa điểm | bắt buộc | |
| startTime | string | thời gian bắt đầu của dữ liệu trả về | 2023-09-01 | bắt buộc |
| endTime | string | thời gian kết thúc của dữ liệu trả về | 2023-09-07 | bắt buộc |
| groupby | enum | chọn khoảng dữ liệu trả về (giờ/ngày) | day/hour | bắt buộc |
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
}
API của đồng hồ đo năng lượng WiFi
IAMMETER cung cấp những khả năng gì?
Loại đồng hồ đo điện nào phù hợp nhất với nhu cầu của bạn?
Cách tìm đồng hồ đo công suất phù hợp với yêu cầu của bạn
Đồng hồ năng lượng Wi-Fi ba pha (WEM3080T)
Đồng hồ năng lượng Wi-Fi một pha (WEM3080)
Đồng hồ năng lượng Wi-Fi ba pha (WEM3046T)
Đồng hồ năng lượng Wi-Fi ba pha (WEM3050T)