정보
| 변수명 | 필수 여부 | 설명 | 사용 예 |
|---|---|---|---|
| apikey | 필수 | 인증키 | |
| bsncd | 선택 | 대권역 |
10 : 한강 11 : 안성천 12 : 한강서해 13 : 한강동해 20 : 낙동강 21 : 형산강 22 : 태화강 23 : 회야수영 24 : 낙동강동해 25 : 낙동강남해 30 : 금강 31 : 삽교천 32 : 금강서해 33 : 만경동진 40 : 섬진강 41 : 섬진강남해 50 : 영산강 51 : 탐진강 52 : 영산강남해 53 : 영산강서해 60 : 제주도 |
| output | 선택 | 출력 포맷 |
xml, json(기본값) |
※ 시자료는 1개월, 일자료는 3개월, 월자료는 1년까지 조회 가능합니다.
https://mulmoa.go.kr/api/v1/dam/stationData?apikey=APIKEY&bsncd=10
| 변수명 | 설명 | 비고 |
|---|---|---|
| DAM_NM | 댐명 | |
| DAM_CD | 댐코드 | |
| UNIT_BSN_CD | 단위지도코드 | |
| MNG_INST_NM | 관할기관 | |
| DAM_TP_CD | 댐형식 | |
| DAM_CL_NM | 댐종류 | |
| LFTBK_VAL | 좌안 | |
| RGTBK_VAL | 우안 | |
| HGHT | 댐높이 | |
| LEN | 댐길이 | |
| VLM | 댐체적 | |
| NML_ALTD | 정상표고 | |
| LOT | 북위 | |
| LAT | 동경 | |
| ADDR | 주소 |
| 오류코드 | 설명 |
|---|---|
| 00 | 정상 처리 |
| 10 | 잘못된 요청 파라미터 |
| 22 | 호출 한도 초과 |
| 30 | 등록되지 않은 API key |
| 31 | 사용할 수 없는 API key(비활성, 차단, 승인대기) |
| 99 | 시스템(기타) 에러 |
const API_URL = 'https://mulmoa.go.kr/api/v1/dam/stationData';
function getObsData() {
axios.get(API_URL)
.then(response => {
const res = response.data;
// 응답 코드 확인
if (res.result.code === '00') {
// 조회 성공 처리
// 총 건수: res.count
// 데이터 목록: res.list
// 여기서 res.list 배열을 활용해 비즈니스 로직 처리
} else {
// API 내부 에러 처리
// 오류 메시지: res.result.msg
}
})
.catch(error => {
// API 호출 중 통신 에러 처리
});
}
<response>
<result>
<code>00</code>
<msg>정상적으로 처리되었습니다.</msg>
</result>
<count>15</count>
<data/>
<list>
<item>
<rownum>1</rownum>
<dam_nm>광동</dam_nm>
<dam_cd>1001210</dam_cd>
<unit_bsn_cd>100109 </unit_bsn_cd>
<mng_inst_nm/>
<dam_tp_cd>ECRD</dam_tp_cd>
<dam_cl_nm>생공전용댐</dam_cl_nm>
<lftbk_val/>
<rgtbk_val/>
<hght>39.500</hght>
<len>292.00</len>
<vlm>616.0</vlm>
<nml_altd>678.500</nml_altd>
<lot>129.0</lot>
<lat>37.3</lat>
<addr/>
</item>
<item>
<rownum>2</rownum>
<dam_nm>괴산댐</dam_nm>
<dam_cd>1004310</dam_cd>
<unit_bsn_cd>100406 </unit_bsn_cd>
<mng_inst_nm/>
<dam_tp_cd/>
<dam_cl_nm>다목적댐</dam_cl_nm>
<lftbk_val/>
<rgtbk_val/>
<hght/>
<len/>
<vlm/>
<nml_altd/>
<lot>127.8</lot>
<lat>36.8</lat>
<addr/>
</item>
<item>
<rownum>3</rownum>
<dam_nm>군남</dam_nm>
<dam_cd>1021701</dam_cd>
<unit_bsn_cd>102108 </unit_bsn_cd>
<mng_inst_nm/>
<dam_tp_cd>CGD</dam_tp_cd>
<dam_cl_nm>기타댐</dam_cl_nm>
<lftbk_val/>
<rgtbk_val/>
<hght>26.000</hght>
<len>658.00</len>
<vlm>178.9</vlm>
<nml_altd>45.000</nml_altd>
<lot>127.0</lot>
<lat>38.1</lat>
<addr/>
</item>
<item>
<rownum>4</rownum>
<dam_nm>소양강</dam_nm>
<dam_cd>1012110</dam_cd>
<unit_bsn_cd>101107 </unit_bsn_cd>
<mng_inst_nm/>
<dam_tp_cd>ECRD</dam_tp_cd>
<dam_cl_nm>다목적댐</dam_cl_nm>
<lftbk_val/>
<rgtbk_val/>
<hght>123.000</hght>
<len>530.00</len>
<vlm>9,591.0</vlm>
<nml_altd>203.000</nml_altd>
<lot>127.8</lot>
<lat>37.9</lat>
<addr/>
</item>
</list>
</response>
| 변수명 | 필수 여부 | 설명 | 사용 예 |
|---|---|---|---|
| apikey | 필수 | 인증키 | |
| obscd | 필수 | 관측소코드 | |
| type | 필수 | 구분 |
1 : 시간별 2 : 일자료 |
| start | 선택 | 조회 시작일 |
년월일 8자리 숫자(YYYYMMDD) |
| end | 선택 | 조회 종료일 |
년월일 8자리 숫자(YYYYMMDD) |
| output | 선택 | 출력 포맷 |
xml, json(기본값) |
※ 시자료는 1개월, 일자료는 3개월, 월자료는 1년까지 조회 가능합니다.
https://mulmoa.go.kr/api/v1/dam/damData?apikey=APIKEY&type=1&obscd=1001210&start=20101122&end=20101122
| 변수명 | 설명 | 비고 |
|---|---|---|
| DAM_NM | 지점명 | |
| DAM_OBSRVN_DE | 년월일 | |
| DAM_OBSRVN_DT | 측정시간 | |
| A_VAL | 현재수위 | |
| B_VAL | 저수량 | |
| C_VAL | 공용량 | |
| D_VAL | 저수율 | |
| E_VAL | 유입량 | |
| F_VAL | 방류량 |
| 오류코드 | 설명 |
|---|---|
| 00 | 정상 처리 |
| 10 | 잘못된 요청 파라미터 |
| 22 | 호출 한도 초과 |
| 30 | 등록되지 않은 API key |
| 31 | 사용할 수 없는 API key(비활성, 차단, 승인대기) |
| 99 | 시스템(기타) 에러 |
const API_URL = 'https://mulmoa.go.kr/api/v1/dam/damData';
function getObsData() {
axios.get(API_URL)
.then(response => {
const res = response.data;
// 응답 코드 확인
if (res.result.code === '00') {
// 조회 성공 처리
// 총 건수: res.count
// 데이터 목록: res.list
// 여기서 res.list 배열을 활용해 비즈니스 로직 처리
} else {
// API 내부 에러 처리
// 오류 메시지: res.result.msg
}
})
.catch(error => {
// API 호출 중 통신 에러 처리
});
}
<response>
<result>
<code>00</code>
<msg>정상적으로 처리되었습니다.</msg>
</result>
<count>23</count>
<data/>
<list>
<item>
<dam_nm>광동</dam_nm>
<dam_obsrvn_de>2010-11-22</dam_obsrvn_de>
<dam_obsrvn_dt>00</dam_obsrvn_dt>
<a_val>671.310</a_val>
<b_val>8.799</b_val>
<c_val>4.331</c_val>
<d_val>67.000</d_val>
<e_val>0.368</e_val>
<f_val>0.368</f_val>
</item>
<item>
<dam_nm>광동</dam_nm>
<dam_obsrvn_de>2010-11-22</dam_obsrvn_de>
<dam_obsrvn_dt>01</dam_obsrvn_dt>
<a_val>671.310</a_val>
<b_val>8.799</b_val>
<c_val>4.331</c_val>
<d_val>67.000</d_val>
<e_val>0.428</e_val>
<f_val>0.428</f_val>
</item>
<item>
<dam_nm>광동</dam_nm>
<dam_obsrvn_de>2010-11-22</dam_obsrvn_de>
<dam_obsrvn_dt>02</dam_obsrvn_dt>
<a_val>671.310</a_val>
<b_val>8.799</b_val>
<c_val>4.331</c_val>
<d_val>67.000</d_val>
<e_val>0.637</e_val>
<f_val>0.637</f_val>
</item>
<item>
<dam_nm>광동</dam_nm>
<dam_obsrvn_de>2010-11-22</dam_obsrvn_de>
<dam_obsrvn_dt>03</dam_obsrvn_dt>
<a_val>671.310</a_val>
<b_val>8.799</b_val>
<c_val>4.331</c_val>
<d_val>67.000</d_val>
<e_val>0.410</e_val>
<f_val>0.410</f_val>
</item>
<item>
<dam_nm>광동</dam_nm>
<dam_obsrvn_de>2010-11-22</dam_obsrvn_de>
<dam_obsrvn_dt>04</dam_obsrvn_dt>
<a_val>671.310</a_val>
<b_val>8.799</b_val>
<c_val>4.331</c_val>
<d_val>67.000</d_val>
<e_val>0.368</e_val>
<f_val>0.368</f_val>
</item>
</list>
</response>
적용된 필터가 없습니다.
검색 필터를 통해 상세한 검색을 해보세요
※ 최종수정일은 데이터셋 정보(메타데이터)의 갱신일이며, 수록 자료의 최종 관측일과 다를 수 있습니다.
※ 파일 데이터의 일부 내용을 제공하고 있으며, 전체 내용이 필요한 경우 해당 파일을 다운로드 받으시기 바랍니다.