댐

사용 설명

Open API를 정확하고 효율적으로 활용할 수 있도록 Open-API 사용 예제를 제공합니다.
요청 URL, 요청 변수, 샘플 URL, 요청 결과 출력, 오류코드 설명 예시가 정리되어 있어 개발 시 참고하여 활용하실 수 있습니다.

요청 URL

http://www.mulmoa.go.kr/openapi/api/v1/dam/stationData

요청 변수

변수명

필수 여부

설명

사용 예

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년까지 조회 가능합니다.

샘플 URL

http://www.mulmoa.go.kr/openapi/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	잘못된 요청 파라미터
11	필수 파라미터 누락
22	호출 한도 초과
30	등록되지 않은 API key
31	사용할 수 없는 API key(비활성, 차단, 승인대기)
99	시스템(기타) 에러

샘플 코드

Open API를 보다 쉽게 활용할 수 있도록 주요 언어별 샘플 코드(Sample Code)를 제공합니다.
제공된 예제를 참고하여 API 호출 방식, 인증 처리, 요청/응답 구조를 빠르게 이해할 수 있으며, 서비스 환경에 맞춰 자유롭게 수정하여 사용할 수 있습니다.

Java

JavaScript


const API_URL = 'http://www.mulmoa.go.kr/openapi/api/v1/dam/stationData';

function getObsData() {
    axios.get(API_URL)
        .then(response => {
            const res = response.data;

            // 응답 코드 확인
            if (res.result.code === '00') {
                console.log(`조회 성공 (총 ${res.count}건)`);
                console.log('데이터 목록:', res.list);

                // 여기서 res.list 배열을 활용해 비즈니스 로직 처리
            } else {
                console.error('API 내부 에러:', res.result.msg);
            }
        })
        .catch(error => {
            console.error('API 호출 중 통신 에러 발생:', error);
        });
}

제공정보 미리보기

                                    {
                                      "result": {
                                        "code": "00",
                                        "msg": "정상적으로 처리되었습니다."
                                      },
                                      "count": 735,
                                      "list": [
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "평창군(월정분교)",
                                          "obscd": "10014010  "
                                        },
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "정선군(정선군2청사)",
                                          "obscd": "10014020  "
                                        },
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "상원사",
                                          "obscd": "10014070  "
                                        },
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "강릉시(대기리)",
                                          "obscd": "10014080  "
                                        },
                                                    .
                                                    .
                                                    .

사용 설명

요청 URL

http://www.mulmoa.go.kr/openapi/api/v1/dam/damData

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
obscd	필수	관측소코드
type	필수	구분	1 : 시간별 2 : 일자료
start	필수	조회 시작일	년월일 8자리 숫자(YYYYMMDD)
end	필수	조회 종료일	년월일 8자리 숫자(YYYYMMDD)
output	선택	출력 포맷	xml(기본값), json

※ 시자료는 1개월, 일자료는 3개월, 월자료는 1년까지 조회 가능합니다.

샘플 URL

http://www.mulmoa.go.kr/openapi/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	잘못된 요청 파라미터
11	필수 파라미터 누락
22	호출 한도 초과
30	등록되지 않은 API key
31	사용할 수 없는 API key(비활성, 차단, 승인대기)
99	시스템(기타) 에러

샘플 코드

Java

JavaScript


const API_URL = 'http://www.mulmoa.go.kr/openapi/api/v1/dam/damData';

function getObsData() {
    axios.get(API_URL)
        .then(response => {
            const res = response.data;

            // 응답 코드 확인
            if (res.result.code === '00') {
                console.log(`조회 성공 (총 ${res.count}건)`);
                console.log('데이터 목록:', res.list);

                // 여기서 res.list 배열을 활용해 비즈니스 로직 처리
            } else {
                console.error('API 내부 에러:', res.result.msg);
            }
        })
        .catch(error => {
            console.error('API 호출 중 통신 에러 발생:', error);
        });
}

제공정보 미리보기

                                    {
                                      "result": {
                                        "code": "00",
                                        "msg": "정상적으로 처리되었습니다."
                                      },
                                      "count": 735,
                                      "list": [
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "평창군(월정분교)",
                                          "obscd": "10014010  "
                                        },
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "정선군(정선군2청사)",
                                          "obscd": "10014020  "
                                        },
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "상원사",
                                          "obscd": "10014070  "
                                        },
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "강릉시(대기리)",
                                          "obscd": "10014080  "
                                        },
                                                    .
                                                    .
                                                    .

물모아 : 국가 통합물관리정보플랫폼

내 주변 물정보

데이터 검색

데이터 활용

참여마당

정보마당

댐

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

댐

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

검색필터

검색 대상

결과 내 재검색