IAMMETER-cloud cung cấp một số API và nhà phát triển có thể sử dụng các API này để thực hiện một số công việc thú vị, chẳng hạn như tích hợp dữ liệu của IAMMETER với một số hệ thống của bên thứ ba. Trước đây, chúng tôi chỉ mở các API này cho các đối tác kinh doanh và một số khách hàng lớn nhưng hiện đã quyết định mở chúng cho tất cả khách hàng của mình.
Chào mừng bạn đến 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ượng cuộc gọi hàng ngày cho mỗi API. Vui lòng không gọi API thường xuyên hơn.
Nếu số lượng cuộc gọi vượt quá giới hạn hàng giờ hoặc hàng ngày thì API sẽ không trả về kết quả nào.
| Không. | API | loại giới hạn | hàng giờ | Hằng ngày | Sự miêu tả |
|---|---|---|---|---|---|
| 1 | /đăng nhập người dùng | ip | 5 | 30 | một IP chỉ được phép gọi api này 5 lần mỗi giờ |
| 2 | /trang web/dữ liệu đo/ | 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/offlinePhân tích | SN | 5 | một SN chỉ được phép gọi api này 5 lần mỗi ngày |
Trả lại token của tài khoản. Mã thông báo sẽ được sử dụng trong gần như tất cả API.
Bạn không cần gọi API này trừ khi bạn muốn làm mới mã thông báo.Vui lòng khô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.
Nhận mã thông báo của tài khoản được sử dụng trong tất cả các API.
URL:https://www.iammeter.com/api/v1/user/login
Phương pháp:bưu kiện
| Không. | tham số | nhận xét | ví dụ |
|---|---|---|---|
| 1 | tên tài khoản | Tên người dùng của IAMMETER | Bài kiểm tra |
| 2 | mật khẩu | mật khẩu của IAMMETER | 123456 |
Giá trị mã thông báo sẽ được sử dụng trong tất cả các API bên dưới.
{
"dữ liệu": {
"id": 2025,
"mã thông báo": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"thành công": đúng,
"tin nhắn": null
}Mã thông báo này cũng có thể được đọc trực tiếp sau khi bạn đăng nhập vào hệ thống.
Nhận dữ liệu tải lên cuối cùng với SN được xem xét.
Vui lòng không gọi API này quá 12 lần trong một giờ.
Cơ bản (dữ liệu đo): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Nâng cao(meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Phương pháp: LẤY
Giới hạn: vui lòng không yêu cầu API này quá 288 lần mỗi ngày (khoảng thời gian 5 phút).
Sự khác biệt giữa cơ bản và nâng cao:
Cơ bản: không có PF (Hệ số công suất)
Nâng cao: với PF (Hệ số công suất)
| Tên | Kiểu | Ví dụ | |
|---|---|---|---|
| Mã thông báo | Sợi dây | xxx | yêu cầu |
định nghĩa giá trị: điện áp, dòng điện, công suất hoạt động, Kwh nhập khẩu, Kwh xuất khẩu
{
"dữ liệu": {
"giá trị": [
[
230.220,
1.300,
119.000,
1766.590,
0,000
]
],
"localTime": "28/8/2020 15:27:33",
"gmtTime": "28/8/2020 5:27:33"
},
"thành công": đúng,
"tin nhắn": null
}định nghĩa giá trị: điện áp, dòng điện, công suất hoạt động,hệ số công suất,Kwh nhập khẩu, Kwh xuất khẩu
{
"dữ liệu":{
"giá trị":[
[
233,41,
0,718,
111,
0,66,
5724,85,
0
]
],
"localTime":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"thành công":đúng,
"tin nhắn":null
}Ba mảng tronggiá trịđại diện cho Giai đoạn A, giai đoạn B và Giai đoạn C.
Định nghĩa phần tử: điện áp, dòng điện, công suất hoạt động,hệ số công suất,Kwh nhập khẩu, Kwh xuất khẩu
{
"dữ liệu": {
"giá trị": [
[
242.600,
1.000,
216.000,
32354.600,
0,000
],
[
242.600,
1.000,
1986.000,
30536.410,
17704.720
],
[
0,000,
0,000,
0,000,
0,000,
0,000
]
],
"giờ địa phương": "28/8/2020 15:30:48",
"gmtTime": "28/8/2020 5:30:48"
},
"thành công": đúng,
"tin nhắn": null
}{
"dữ liệu":{
"giá trị":[
[//giai đoạn A
233,8,//điện áp
0,03,//hiện tại
4,//công suất hoạt động
0,57,//hệ số công suất
222,53,//Kwh nhập khẩu
0 // Kwh xuất khẩu
],
[//giai đoạn B
5,
0,
0,
0,
0,
0
],
[ //giai đoạn C
3.1,
0,
0,
0,
0,
0
]
],
"localTime":"2023/11/21 14:39:36",
"gmtTime":"2023/11/21 6:39:36"
},
"thành công":đúng,
"tin nhắn":null
}
Trả về dữ liệu lịch sử về khoảng thời gian và phạm vi thời gian đã đặt.
Dữ liệu tức thời cách nhau 1 phút. Có 60*24=1440 mẩu dữ liệu mỗi ngày. Nếu bạn yêu cầu dữ liệu lịch sử trong khoảng thời gian 1 phút, bạn chỉ có thể yêu cầu dữ liệu trong 1,39 (2000/1440) ngày. Nhưng nếu bạn yêu cầu dữ liệu trong khoảng thời gian 5 phút, bạn có thể yêu cầu dữ liệu trong gần 7 ngày.
Cơ bản (nhà đo dữ liệu):https://www.iammeter.com/api/v1/site/meterdatalist/
**Nâng cao(meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Sự khác biệt giữa cơ bản và nâng cao:
Cơ bản: không có PF (Hệ số công suất)
Nâng cao: với PF (Hệ số công suất)
| Tên | Kiểu | Ví dụ | |
|---|---|---|---|
| Mã thông báo | Sợi dây | xxx | yêu cầu |
| khoảng thời gian | con số | 300 | bắt buộc, đơn vị: giây |
| thời gian bắt đầu | sợi dây | 2023-09-01 | yêu cầu |
| thời gian kết thúc | sợi dây | 2023-09-07 | yêu cầu |
Dữ liệu: [điện áp, dòng điện, công suất, năng lượng nhập khẩu, năng lượng xuất khẩu, giờ utc, giờ địa phương]
{
"dữ liệu": [
[
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"
]
],
"thành công": đúng,
"tin nhắn": null
}{
"dữ liệu": [
[
230,//phaA điện áp
0,//hiện tại
0,//công suất hoạt động
468,41,//kWh nhập khẩu
0,//kWh xuất khẩu
230,//Giai đoạn B
0,
0,
236,58,
290,77,
230,//Giai đoạn 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"
]
],
"thành công": đúng,
"tin nhắn": null
}{
"dữ liệu":[
{ //dữ liệu đầu tiên
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"giá trị":[
[ //giai đoạn A
235.2,//điện áp
0,03,//hiện tại
4,//công suất hoạt động
0,57,//hệ số công suất
210,21,//nhập Kwh
0 // Kwh xuất khẩu
],
[//giai đoạn B
5,5,
0,
0,
0,
0,
0
],
[ //giai đoạn 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",
"giá trị":[
[
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",
"giá trị":[
[
235,6,
0,03,
4,
0,57,
210,27,
0
],
[
5,5,
0,
0,
0,
0,
0
],
[
3,4,
0,
0,
0,
0,
0
]
]
}
],
"thành công":đúng,
"tin nhắn":null
}
Trả về kết quả phân tích công suất trong thời gian quy định.
Vui lòng không gọi API này quá 5 lần trong một ngày.
URL:https://www.iammeter.com/api/v1/site/powerAnalysis
Phương pháp: lấy
Giới hạn: Vui lòng khô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 |
Sợi dây | xxx | yêu cầu |
thời gian bắt đầu |
Sợi dây | 2023-09-01 | không bắt buộc |
thời gian kết thúc |
Sợi dây | 2023-09-07 | không bắt buộc |
Ghi chú:
trung bình: đọc 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 Ban ngày (8:00 sáng - 8:00 tối) trong khoảng thời gian này.
tối thiểu: đọc công suất tối thiểu trong phạm vi thời gian này.
tối đa: đọc công suất tối đa trong phạm vi thời gian này.
{
"dữ liệu": {
"thời gian bắt đầu": "2023-09-01",
"thời gian kết thúc": "2023-09-07",
"trung bình": 862,6,
"trung bình ban ngày": 836,9,
"tối thiểu": 259,0,
"tối đa": 3999.0
},
"thành công": đúng,
"tin nhắn": 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 ngắt kết nối với SN được đánh giá trong thời gian đã chỉ định.
Vui lòng không gọi API này quá 5 lần trong một ngày.
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
Phương pháp：Lấy
Giới hạn: Vui lòng khô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 |
Sợi dây | xxxx | yêu cầu |
thời gian bắt đầu |
Sợi dây | 2023-09-01 | không bắt buộc |
thời gian kết thúc |
Sợi dây | 2023-09-07 | không bắt buộc |
khoảng thời gian(đơn vị: phút) |
Con số | 5 | không bắt buộc |
Ghi chú:
Có tổng cộng 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 cách ngoại tuyến lớn hơn 5 phút được liệt kê trong mảng.
{
"dữ liệu": {
"thời gian bắt đầu": "2023-09-05",
"thời gian kết thúc": "2023-09-11",
"đếm ngoại tuyến": 906,
"tổng số": 10080,
"danh sách": [
{
"thời gian bắt đầu": "2023/9/5 0:00:00",
"thời gian kết thúc": "2023/9/5 15:06:14",
"thời lượng": 906
}
]
},
"thành công": đúng,
"tin nhắn": null
}Trả về kết quả phân tích offline của ngày được chỉ định
API của đồng hồ đo năng lượng WiFi
Đồng hồ đo năng lượng Wi-Fi ba pha
Đồng hồ đo năng lượng Wi-Fi một pha