IAMMETER-cloud는 일부 API를 제공하며 개발자는 이러한 API를 사용하여 IAMMETER의 데이터를 일부 타사 시스템에 통합하는 등의 흥미로운 작업을 수행할 수 있습니다. 이전에는 이러한 API를 비즈니스 파트너와 일부 대규모 고객에게 공개했지만 이제는 모든 고객에게 공개하기로 결정했습니다.
우리 포럼에 귀하의 생각을 알려주신 것을 환영합니다.https://imeter.club
API는 무제한으로 방문할 수 없으며, 각 API의 일일 호출 횟수를 제한합니다. API를 더 자주 호출하지 마십시오.
호출 수가 시간별 또는 일일 제한을 초과하면 API는 아무것도 반환하지 않습니다.
| 아니요. | API | 한도 유형 | 매시간 | 일일 | 설명 |
|---|---|---|---|---|---|
| 1 | /사용자/로그인 | 아이피 | 5 | 30 | 하나의 IP만 이 API를 시간당 5회 호출하도록 허용됩니다. |
| 2 | /사이트/미터데이터/ | SN | 12 | 하나의 SN은 이 API를 시간당 12번만 호출할 수 있습니다. | |
| 3 | /site/power분석 | SN | 5 | 하나의 SN은 하루에 5번만 이 API를 호출할 수 있습니다. | |
| 4 | /site/offline분석 | SN | 5 | 하나의 SN은 하루에 5번만 이 API를 호출할 수 있습니다. |
계정의 토큰을 반환합니다. 토큰은 거의 모든 API에서 사용됩니다.
토큰을 새로 고치려는 경우가 아니면 이 API를 호출할 필요가 없습니다.이 API를 한 시간에 5번 이상, 하루에 30번 이상 호출하지 마세요.
모든 API에서 사용되는 계정의 토큰을 가져옵니다.
URL:https://www.iammeter.com/api/v1/user/login
방법:우편
| 아니요. | 매개변수 | 주목 | 예 |
|---|---|---|---|
| 1 | 사용자 이름 | IAMMETER의 사용자 이름 | 시험 |
| 2 | 비밀번호 | IAMMETER의 비밀번호 | 123456 |
토큰 값은 아래의 모든 API에서 사용됩니다.
{
"데이터": {
"ID": 2025,
"토큰": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"성공": 사실,
"메시지": null
}이 토큰은 시스템에 로그인한 후 직접 읽을 수도 있습니다.
해당 SN으로 마지막 업로드 데이터를 가져옵니다.
한 시간에 이 API를 12번 이상 호출하지 마세요.
기본(미터데이터): https://www.iammeter.com/api/v1/site/meterdata/{sn}
고급(미터데이터2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
방법: 얻다
한계: 이 API를 하루에 288회 이상(5분 간격) 요청하지 마세요.
기본과 고급의 차이점:
기본 : PF 없음(역률)
고급: PF(역률) 포함
| 이름 | 유형 | 예 | |
|---|---|---|---|
| 토큰 | 끈 | 트리플 엑스 | 필수의 |
값 정의: 전압, 전류, 유효 전력, 수입 Kwh, 수출 Kwh
{
"데이터": {
"값": [
[
230.220,
1,300,
119.000,
1766.590,
0.000
]
],
"localTime": "2020/8/28 15:27:33",
"gmtTime": "2020/8/28 5:27:33"
},
"성공": 사실,
"메시지": null
}값 정의: 전압, 전류, 유효 전력,역률,수입 Kwh, 수출 Kwh
{
"데이터":{
"값":[
[
233.41,
0.718,
111,
0.66,
5724.85,
0
]
],
"localTime":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"성공": 사실,
"메시지":널
}3개의 배열가치A단계, B단계, C단계를 나타냅니다.
요소 정의: 전압, 전류, 유효 전력,역률,수입 Kwh, 수출 Kwh
{
"데이터": {
"값": [
[
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
]
],
"localTime": "2020/8/28 15:30:48",
"gmtTime": "2020/8/28 5:30:48"
},
"성공": 사실,
"메시지": null
}{
"데이터":{
"값":[
[//A단계
233.8,//전압
0.03,//현재
4,//유효 전력
0.57,//역률
222.53,//수입 Kwh
0 //Kwh를 내보냈습니다.
],
[//B단계
5,
0,
0,
0,
0,
0
],
[ //단계 C
3.1,
0,
0,
0,
0,
0
]
],
"localTime":"2023/11/21 14:39:36",
"gmtTime":"2023/11/21 6:39:36"
},
"성공": 사실,
"메시지":널
}
설정된 간격과 시간 범위에 대한 기록 데이터를 반환합니다.
인스턴트 데이터는 1분 간격입니다. 하루에 60*24=1440개의 데이터가 있습니다. 1분 간격으로 과거 데이터를 요청할 경우 1.39(2000/1440)일의 데이터만 요청할 수 있습니다. 하지만 5분 간격으로 데이터를 요청하면 거의 7일 동안의 데이터를 요청할 수 있습니다.
기본(미터데이터 목록):https://www.iammeter.com/api/v1/site/meterdatalist/
**고급(미터데이터목록2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
기본과 고급의 차이점:
기본 : PF 없음(역률)
고급: PF(역률) 포함
| 이름 | 유형 | 예 | |
|---|---|---|---|
| 토큰 | 끈 | 트리플 엑스 | 필수의 |
| 간격 | 숫자 | 300 | 필수, 단위: 초 |
| 시작 시간 | 끈 | 2023-09-01 | 필수의 |
| 종료시간 | 끈 | 2023-09-07 | 필수의 |
데이터:[전압, 전류, 전력, 수입 에너지, 수출 에너지, UTC 시간, 현지 시간]
{
"데이터": [
[
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"
]
],
"성공": 사실,
"메시지": null
}{
"데이터": [
[
230,//상A 전압
0,//현재
0,//유효전력
468.41,//수입kWh
0,//kWh를 내보냈습니다.
230,//단계 B
0,
0,
236.58,
290.77,
230,//단계 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"
]
],
"성공": 사실,
"메시지": null
}{
"데이터":[
{ //첫 번째 데이터
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"값":[
[ //A단계
235.2,//전압
0.03,//현재
4,//유효 전력
0.57,//역률
210.21,//Kwh 가져오기
0 //Kwh를 내보냈습니다.
],
[//B단계
5.5,
0,
0,
0,
0,
0
],
[ //단계 C
3.3,
0,
0,
0,
0,
0
]
]
},
{ //두 번째 데이터
"rtcTime":"2023/9/1 8:00:49",
"gmtTime":"2023/9/1 0:00:49",
"값":[
[
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",
"값":[
[
235.6,
0.03,
4,
0.57,
210.27,
0
],
[
5.5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
"성공": 사실,
"메시지":널
}
지정된 시간에 전력 분석 결과를 반환합니다.
이 API를 하루에 5번 이상 호출하지 마세요.
URL:https://www.iammeter.com/api/v1/site/powerAnalytic
방법: 얻다
한계: 본 API는 SN당 하루 5회 이상 요청하지 마세요.
| 이름 | 유형 | 예 | |
|---|---|---|---|
sn |
끈 | 트리플 엑스 | 필수의 |
시작 시간 |
끈 | 2023-09-01 | 선택 과목 |
종료시간 |
끈 | 2023-09-07 | 선택 과목 |
메모:
평균: 이 시간 범위 동안의 평균 전력 판독값입니다.
averageDaytime: 이 시간 범위 동안의 평균 주간(오전 8시~오후 8시) 전력 판독값입니다.
최소: 이 시간 범위 동안의 최소 전력 판독값입니다.
maximum: 이 시간 범위 동안의 최대 전력 판독값입니다.
{
"데이터": {
"startTime": "2023-09-01",
"종료 시간": "2023-09-07",
"평균": 862.6,
"평균주간": 836.9,
"최소": 259.0,
"최대": 3999.0
},
"성공": 사실,
"메시지": null
}지난 7일간의 전력 분석 결과를 반환합니다.
특정일의 전력분석 결과를 반환
지정된 시간에 해당 SN과의 연결 끊김 상태를 반환합니다.
이 API를 하루에 5번 이상 호출하지 마세요.
URL：https://www.iammeter.com/api/v1/site/offlineAnalytic
방법：얻다
한계: 본 API는 SN당 하루 5회 이상 요청하지 마세요.
| 이름 | 유형 | 예 | |
|---|---|---|---|
sn |
끈 | xxxxx | 필수의 |
시작 시간 |
끈 | 2023-09-01 | 선택 과목 |
종료시간 |
끈 | 2023-09-07 | 선택 과목 |
간격(단위:분) |
숫자 | 5 | 선택 과목 |
메모:
이 시간 범위에는 총 10080분이 있습니다.
이 시간 범위에서 총 오프라인 시간은 906분입니다.
5분보다 큰 오프라인 간격이 배열에 나열됩니다.
{
"데이터": {
"startTime": "2023-09-05",
"종료시간": "2023-09-11",
"offlineCount": 906,
"총 개수": 10080,
"목록": [
{
"startTime": "2023/9/5 0:00:00",
"종료시간": "2023/9/5 15:06:14",
"기간": 906
}
]
},
"성공": 사실,
"메시지": null
}지정된 날짜의 오프라인 분석 결과를 반환합니다.
이 계정의 모든 에너지 측정기의 최신 값을 반환합니다.
URL：https://www.iammeter.com/api/v1/site/metersdata?token=xxx
방법：얻다
한계: 이 API에 5분에 한 번 이상 요청하지 않도록 주의하세요.
| 이름 | 유형 | 예 | |
|---|---|---|---|
| 토큰 | 끈 | 트리플 엑스 | 필수의 |
{
"데이터":[
{
"sn":"DA2BED94",
"값":[
223.71,
1.74,
225,
14761.03,
0
],
"gmtTime":"2024/2/22 3:46:20"
},
{
"sn":"B384789C",
"값":[
[
248.9,
13.9,
3356,
21228,
0,
없는,
없는
],
[
248.9,
13.9,
-2747,
8988.48,
18489.44,
없는,
없는
],
[
없는,
없는,
없는,
없는,
없는,
없는,
없는
],
[
248.9,
13.9,
-2747,
8988.48,
18489.44,
없는,
없는
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
"sn":"674B1E5D",
"값":[
[
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",
"값":[
[
245.3,
6.5,
1604,
46055.7,
0,
없는,
없는
],
[
245.3,
6.5,
-910,
15726.73,
8956.56,
없는,
없는
],
[
없는,
없는,
없는,
없는,
없는,
없는,
없는
],
[
245.3,
6.5,
-910,
15726.73,
8956.56,
없는,
없는
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
"sn":"3FE34ABE",
"값":[
[
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"
}
],
"성공": 사실,
"메시지":널
}
인버터 발전 및 계통 교환을 위한 시간별/일별 kWh 값 검색(내보내기 및 가져오기 모두)
URL：https://www.iammeter.com/api/v1/site/energyhistory/?시작 시간={2024-05-05}&종료시간={2024-07-07}&그룹바이=&토큰={2be6d1xxxxxxcc688}
방법: 얻다
한계：
groupby = 일 :90일 데이터 (90개 데이터)
groupby = 시간:7일 데이터 (168개 데이터)
| 이름 | 유형 | 데스 | 예 | |
|---|---|---|---|---|
| 토큰 | 끈 | 계정의 토큰 | 트리플 엑스 | 필수의 |
| 장소_ID | 숫자 | 장소의 ID | 필수의 | |
| 시작 시간 | 끈 | 이 API 반환의 시작 시간 | 2023-09-01 | 필수의 |
| 종료시간 | 끈 | 이 API 반환의 중지 시간 | 2023-09-07 | 필수의 |
| 그룹화 | 열거형 | 반환 데이터 간격(시간/일) 선택 | 일/시간 | 필수의 |
장소_ID: 내 장소->수정
place_id:1360
시작시간=2024-05-05
종료시간=2024-05-07
그룹별=일
{
"데이터": [{
"시간": "2024/5/5 0:00:00",
"수율": 0,
"fromGrid": 9.62,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/6 0:00:00",
"수율": 0,
"fromGrid": 9.16,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
}
],
"성공": 사실,
"메시지": null
}place_id:2393
시작시간=2024-05-05
종료시간=2024-05-07
그룹별=일
{
"데이터": [{
"시간": "2024/5/5 0:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/6 0:00:00",
"수율": 0.1,
"fromGrid": 0.22,
"toGrid": 7.15,
"특수로드": 0,
"자체 사용": 0
}
],
"성공": 사실,
"메시지": null
}place_id:2393
시작시간=2024-05-05
종료시간=2024-05-06
그룹별=시간
{
"데이터": [{
"시간": "2024/5/5 0:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 1:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 2:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 3:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 4:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 5:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 6:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 7:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 8:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 9:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 10:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 11:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 12:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 13:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 14:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 15:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 16:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 17:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 18:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 19:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 20:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 21:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 22:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
},
{
"시간": "2024/5/5 23:00:00",
"수율": 0,
"fromGrid": 0,
"toGrid": 0,
"특수로드": 0,
"자체 사용": 0
}
],
"성공": 사실,
"메시지": null
}
