IAMMETER-cloud는 일부 API를 제공하며, 개발자는 이러한 API를 사용하여 IAMMETER의 데이터를 타사 시스템에 통합하는 등 흥미로운 작업을 수행할 수 있습니다. 이전에는 이러한 API를 비즈니스 파트너와 일부 대규모 고객에게만 공개했었지만, 이제는 모든 고객에게 공개하기로 결정했습니다.
의견이 있으시면 포럼에서 알려주시기 바랍니다. https://imeter.club
API는 무제한으로 호출할 수 없으며, 각 API의 일일 호출 횟수를 제한합니다. API를 너무 자주 호출하지 마십시오.
시간별 또는 일일 제한을 초과하면 API가 아무것도 반환하지 않습니다.
| 번호 | 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를 호출할 필요가 없습니다. 한 시간에 5회 이상, 하루에 30회 이상 이 API를 호출하지 마십시오.
모든 API에서 사용되는 계정의 토큰을 가져옵니다.
URL: https://www.iammeter.com/api/v1/user/login
메서드: post
이 API는 IAMMETER SwaggerUI get token에서 온라인으로 테스트할 수 있습니다.
| 번호 | 매개변수 | 설명 | 예시 |
|---|---|---|---|
| 1 | user name | IAMMETER의 사용자 이름 | test |
| 2 | password | IAMMETER의 비밀번호 | 123456 |
토큰 값은 아래의 모든 API에서 사용됩니다.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
이 토큰은 시스템에 로그인한 후 직접 읽을 수도 있습니다.
해당 SN의 마지막 업로드 데이터를 가져옵니다.
한 시간에 12회 이상 이 API를 호출하지 마십시오.
기본(meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
이 API는 IAMMETER SwaggerUI에서 온라인으로 테스트할 수 있습니다.
고급(meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
이 API는 IAMMETER SwaggerUI meterdata 및 IAMMETER SwaggerUI meterdata2에서 온라인으로 테스트할 수 있습니다.
메서드: GET
제한: 이 API를 하루 288회(5분 간격) 이상 요청하지 마십시오.
기본과 고급의 차이점:
기본: PF(역률) 없음
고급: PF(역률) 포함
| 이름 | 유형 | 예시 | |
|---|---|---|---|
| Token | String | xxx | 필수 |
| rtctime | string | 2025-6-16 | 선택사항 |
값 정의: 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
}
값 정의: voltage, current, active power, power factor, imported kWh, exported kWh.
역률을 유효전력과 수입 에너지 사이에 배치하는 것이 최적의 방식이 아니라는 점을 인지하고 있지만, 현재 형식이 이미 이렇게 설정되어 있습니다—이 배열에 유의하시기 바랍니다.
{
"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의 세 배열은 A상, B상, 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일의 데이터를 요청할 수 있습니다.
기본(meterdatalist): https://www.iammeter.com/api/v1/site/meterdatalist/{sn}
고급(meterdatalist2): https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
기본과 고급의 차이점:
기본: PF(역률) 없음
고급: PF(역률) 포함
이 API는 IAMMETER SwaggerUI meterdata 및 IAMMETER SwaggerUI meterdata2에서 온라인으로 테스트할 수 있습니다.
| 이름 | 유형 | 예시 | |
|---|---|---|---|
| Token | String | xxx | 필수 |
| interval | number | 300 | 필수, 단위: 초 |
| startTime | string | 2023-09-01 | 필수 |
| endTime | string | 2023-09-07 | 필수 |
데이터: [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":[
{ //첫번째 데이터
"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
]
]
},
{ //두번째 데이터
"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
]
]
},
{ //세번째 데이터
"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
}
지정된 시간의 전력 분석 결과를 반환합니다.
하루에 5회 이상 이 API를 호출하지 마십시오.
URL: https://www.iammeter.com/api/v1/site/powerAnalysis
메서드: get
제한: SN당 이 API를 하루 5회 이상 요청하지 마십시오.
| 이름 | 유형 | 예시 | |
|---|---|---|---|
sn |
String | xxx | 필수 |
startTime |
String | 2023-09-01 | 선택사항 |
endTime |
String | 2023-09-07 | 선택사항 |
참고:
average: 이 시간 범위 동안의 평균 전력 판독값입니다.
averageDaytime: 이 시간 범위 동안의 평균 주간(오전 8시~오후 8시) 전력 판독값입니다.
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의 연결 끊김 상태를 반환합니다.
하루에 5회 이상 이 API를 호출하지 마십시오.
URL: https://www.iammeter.com/api/v1/site/offlineAnalysis
메서드: Get
제한: SN당 이 API를 하루 5회 이상 요청하지 마십시오.
| 이름 | 유형 | 예시 | |
|---|---|---|---|
sn |
String | xxxx | 필수 |
startTime |
String | 2023-09-01 | 선택사항 |
endTime |
String | 2023-09-07 | 선택사항 |
interval(단위: 분) |
Number | 5 | 선택사항 |
참고:
이 시간 범위에는 총 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
메서드: Get
제한: 이 API에 5분에 한 번보다 더 자주 요청하지 마십시오.
| 이름 | 유형 | 예시 | |
|---|---|---|---|
| Token | String | xxx | 필수 |
{
"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
}
인버터 발전 및 그리드 교환(수출 및 수입 모두)에 대한 시간별/일일 kWh 값을 검색합니다.
메서드: get
제한:
groupby = day: 90일 데이터(90개 데이터)
groupby = hour: 7일 데이터(168개 데이터)
| 이름 | 유형 | 설명 | 예시 | |
|---|---|---|---|---|
| Token | String | 계정의 토큰 | xxx | 필수 |
| place_ID | number | 장소의 ID | 필수 | |
| startTime | string | 이 API 반환의 시작 시간 | 2023-09-01 | 필수 |
| endTime | string | 이 API 반환의 종료 시간 | 2023-09-07 | 필수 |
| groupby | enum | 반환 데이터 간격 선택(시간/일) | day/hour | 필수 |
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
}
