치수시설현황

사용 설명

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

요청 URL

http://www.mulmoa.go.kr/openapi/api/v1/floodControlFacility/leveesStatus

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
type	필수	구분	1 : 행정구역 2 : 권역
basin	선택	권역	1 : 한강 2 : 낙동강 3 : 금강 4 : 섬진강 5 : 영산강 6 : 제주도
admcd	선택	행정구역	11 : 서울특별시 26 : 부산광역시 27 : 대구광역시 28 : 인천광역시 29 : 광주광역시 30 : 대전광역시 31 : 울산광역시 36 : 세종특별자치시 41 : 경기도 42 : 강원도 43 : 충청북도 44 : 충청남도 45 : 전라북도 46 : 전라남도 47 : 경상북도 48 : 경상남도 50 : 제주특별자치도
output	선택	출력 포맷	xml(기본값), json

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

샘플 URL

http://www.mulmoa.go.kr/openapi/api/v1/floodControlFacility/leveesStatus?apikey=APIKEY&type=1&admcd=41

요청결과 출력

결과 변수
변수명	설명	비고
lev_nm	제방명
rivnm	하천명
rivdv	하천 등급
pumplr	좌우안
lev_prlg	구간연장
plan_fldqty	계획홍수량
plan_fdwl	계획홍수위
stpt_addr	시점 위치
stpt_msrept	시점 측점
edpnt_addr	종점 위치
edpnt_msrept	종점 측점
plan_wr	계획하폭
lev_wdt	둑마루폭
prll_grdnt	사면경사 제내
rvrsl_grdnt	사면경사 제외
rvtmnt_frm	호안형식

오류코드 설명

오류코드 설명
오류코드	설명
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/floodControlFacility/leveesStatus';

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/floodControlFacility/leveesSpecs

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
code	필수	제방코드
output	선택	출력 포맷	xml(기본값), json

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

샘플 URL

http://www.mulmoa.go.kr/openapi/api/v1/floodControlFacility/leveesSpecs?apikey=APIKEY

요청결과 출력

결과 변수
변수명	설명	비고
lev_id	제방코드
RVR_NM	하천명
grade	하천등급
lev_nm	제방명
lr	좌우안
wtrsc_msirb_cd	중권역코드
stpt_addr	위치-시점
stpt_xcrd	시점TM(X)
stpt_ycrd	시점TM(Y)
edpnt_addr	위치-종점
edpnt_xcrd	종점TM(X)
edpnt_ycrd	종점TM(Y)
lev_prlg	제방연장	(m)
lev_wdt	둑마루폭	(m)
prll_grdnt	비탈면경사-제내
plan_fldqty	계획홍수량
plan_wr	계획하폭
plan_fdwl	계획홍수위
rvrsl_grdnt	비탈면경사-제외
prll_prst	제내지현황
rvrsl_prst	제외지현황
fclty_prst_wtgt	시설물현황(개소)-수문
fclty_prst_slg	시설물현황(개소)-통문
fclty_prst_cscl	시설물현황(개소)-통관
fclty_prst_dg_pumpst	시설물현황(개소)-배수펌프장
lev_sft_lvbd	제방 안정성-제체
lev_sft_etc	제방 안정성 기타
lev_utztn_mng_road	제방 독마루이용 관리용도로 포장종류
lev_utztn_road	제방 독마루이용 도로 포장종류
hgh_rvtmnt_knd	호안 고수호한 종류
hgh_rvtmnt_stts	호안 고수호한 상태
ftprot_knd	호안 밑다짐 종류
ftprot_stts	호안 밑다짐 상태
low_rvtmnt_knd	호안 저수호안 종류
low_rvtmnt_stts	호안 저수호안 상태
flwcnl_dvlp_prst	하도 유로발달 현황
csshp	하도 횡단면형
rvbd_cpst_slprpt	하도 하상구성토질

오류코드 설명

오류코드 설명
오류코드	설명
00	정상 처리
10	잘못된 요청 파라미터
11	필수 파라미터 누락
22	호출 한도 초과
30	등록되지 않은 API key
31	사용할 수 없는 API key(비활성, 차단, 승인대기)
99	시스템(기타) 에러

샘플 코드

Java

JavaScript


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

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/floodControlFacility/drainageFacilitiesStatus

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
type	필수	구분	1 : 행정구역 2 : 권역
basin	선택	권역	1 : 한강 2 : 낙동강 3 : 금강 4 : 섬진강 5 : 영산강 6 : 제주도
admcd	선택	행정구역	11 : 서울특별시 26 : 부산광역시 27 : 대구광역시 28 : 인천광역시 29 : 광주광역시 30 : 대전광역시 31 : 울산광역시 36 : 세종특별자치시 41 : 경기도 42 : 강원도 43 : 충청북도 44 : 충청남도 45 : 전라북도 46 : 전라남도 47 : 경상북도 48 : 경상남도 50 : 제주특별자치도
output	선택	출력 포맷	xml(기본값), json

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

샘플 URL

http://www.mulmoa.go.kr/openapi/api/v1/floodControlFacility/drainageFacilitiesStatus?apikey=APIKEY

요청결과 출력

결과 변수
변수명	설명	비고
fclt_nm	시설명
rivnm	하천명
rivdv	하천등급
addr	위치
msrept	측점
pumplr	좌우안
strct_frm	구조형식	(HP×구경(㎜)×대)
dtn_cpct	유수지용량	(m³)
flddmg_area	수혜면적	(㎢)
ppqty	양수량	(m³/분)

오류코드 설명

오류코드 설명
오류코드	설명
00	정상 처리
10	잘못된 요청 파라미터
11	필수 파라미터 누락
22	호출 한도 초과
30	등록되지 않은 API key
31	사용할 수 없는 API key(비활성, 차단, 승인대기)
99	시스템(기타) 에러

샘플 코드

Java

JavaScript


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

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/floodControlFacility/drainageFacilitiesSpecs

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
code	필수	내수배제시설코드
output	선택	출력 포맷	xml(기본값), json

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

샘플 URL

http://www.mulmoa.go.kr/openapi/api/v1/floodControlFacility/drainageFacilitiesSpecs?apikey=APIKEY

요청결과 출력

결과 변수
변수명	설명	비고
RVR_NM	하천명
grade	하천등급
wtrsc_std_bsn_cd	표준유역코드
fclt_nm	시설물명
inwtr_exclu_fclt_id	시설코드
lr	좌우안
addr	위치
wgs84_lot	좌표-경도
xcrd	TM(X)
wgs84_lat	좌표-위도
ycrd	TM(Y)
strct_frm	구조형식 (HP×구경(㎜)×대)
flddmg_area	수혜면적(㎢)
ppqty	양수량(m³/분)
fclty_stts	시설물상태

오류코드 설명

오류코드 설명
오류코드	설명
00	정상 처리
10	잘못된 요청 파라미터
11	필수 파라미터 누락
22	호출 한도 초과
30	등록되지 않은 API key
31	사용할 수 없는 API key(비활성, 차단, 승인대기)
99	시스템(기타) 에러

샘플 코드

Java

JavaScript


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

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/floodControlFacility/gatesStatus

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
type	필수	구분	1 : 행정구역 2 : 권역
basin	선택	권역	1 : 한강 2 : 낙동강 3 : 금강 4 : 섬진강 5 : 영산강 6 : 제주도
admcd	선택	행정구역	11 : 서울특별시 26 : 부산광역시 27 : 대구광역시 28 : 인천광역시 29 : 광주광역시 30 : 대전광역시 31 : 울산광역시 36 : 세종특별자치시 41 : 경기도 42 : 강원도 43 : 충청북도 44 : 충청남도 45 : 전라북도 46 : 전라남도 47 : 경상북도 48 : 경상남도 50 : 제주특별자치도
output	선택	출력 포맷	xml(기본값), json

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

샘플 URL

http://www.mulmoa.go.kr/openapi/api/v1/floodControlFacility/gatesStatus?apikey=APIKEY

요청결과 출력

결과 변수
변수명	설명	비고
fclt_nm	시설명
rivnm	하천명
rivdv	하천등급
addr	위치
msrept	측점
pumplr	좌우안
strct_frm	구조형식

오류코드 설명

오류코드 설명
오류코드	설명
00	정상 처리
10	잘못된 요청 파라미터
11	필수 파라미터 누락
22	호출 한도 초과
30	등록되지 않은 API key
31	사용할 수 없는 API key(비활성, 차단, 승인대기)
99	시스템(기타) 에러

샘플 코드

Java

JavaScript


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

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/floodControlFacility/gatesSpecs

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
code	필수	수문통관통문코드
output	선택	출력 포맷	xml(기본값), json

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

샘플 URL

http://www.mulmoa.go.kr/openapi/api/v1/floodControlFacility/gatesSpecs?apikey=APIKEY

요청결과 출력

결과 변수
변수명	설명	비고
RVR_NM	하천명
grade	하천등급
fclt_nm	시설물명
wtgt_cscl_slg_fclt_id	시설코드
type	시설구분
lr	좌우안
wtrsc_std_bsn_cd	표준유역코드
addr	위치
wgs84_lot	좌표-경도
xcrd	TM(X)
wgs84_lat	좌표-위도
ycrd	TM(Y)
strct_frm	구조형식	(HP×구경(㎜)×대)
fclty_stts	시설물상태

오류코드 설명

오류코드 설명
오류코드	설명
00	정상 처리
10	잘못된 요청 파라미터
11	필수 파라미터 누락
22	호출 한도 초과
30	등록되지 않은 API key
31	사용할 수 없는 API key(비활성, 차단, 승인대기)
99	시스템(기타) 에러

샘플 코드

Java

JavaScript


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

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

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

검색필터

검색 대상

결과 내 재검색