농업용 수리시설

사용 설명

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

요청 URL

https://mulmoa.go.kr/api/v1/waterUseFacility/reservoirs

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
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

https://mulmoa.go.kr/api/v1/waterUseFacility/reservoirs?apikey=APIKEY&type=1&admcd=41

요청결과 출력

결과 변수
변수명	설명	비고
rsrvr_nm	시설명
drght_freq	한발빈도
bsn_area	유역면적
vld_rscpt	유효 저수량
dm_frm	댐형식
TOT_AREA	관개면적 계
ntiar	순관개면적
idrar	관배수면적
zone_excl_watsup_area	구역외급수면적
wtrsrc_tool_mi	수원공구분
addr	소재지
fwlvar	만수위면적
rsrvr_hgt	저수지 높이
rsrvr_len	저수지 길이
sncn_area	인가면적
bgncst_yr	착공년도
cmcn_yr	준공년도
cmptnc_inst_nm	관할기관
wtrsc_std_bsn_cd	표준유역코드
std_bsn_nm	표준유역명

오류코드 설명

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

샘플 코드

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

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/waterUseFacility/reservoirs';

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>331</count>
    <data/>
    <list>
        <item>
            <rsrvr_nm>팔용당</rsrvr_nm>
            <drght_freq>7</drght_freq>
            <bsn_area>25</bsn_area>
            <vld_rscpt>14</vld_rscpt>
            <dm_frm/>
            <tot_area>5.7</tot_area>
            <ntiar>5.7</ntiar>
            <idrar/>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>주</wtrsrc_tool_mi>
            <addr>경기도 평택시 송탄동 (도일동)181번지</addr>
            <fwlvar>2</fwlvar>
            <rsrvr_hgt>5.4</rsrvr_hgt>
            <rsrvr_len>135</rsrvr_len>
            <sncn_area>40.7</sncn_area>
            <bgncst_yr>1945</bgncst_yr>
            <cmcn_yr>1945</cmcn_yr>
            <cmptnc_inst_nm>평택시</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>110108</wtrsc_std_bsn_cd>
            <std_bsn_nm>진위천합류전</std_bsn_nm>
        </item>
        <item>
            <rsrvr_nm>서동</rsrvr_nm>
            <drght_freq>1</drght_freq>
            <bsn_area>270</bsn_area>
            <vld_rscpt>29.5</vld_rscpt>
            <dm_frm>토언제중심점토형</dm_frm>
            <tot_area>17</tot_area>
            <ntiar>17</ntiar>
            <idrar/>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>주</wtrsrc_tool_mi>
            <addr>경기도 오산시 초평동 (서동)292-1번지</addr>
            <fwlvar>3.6</fwlvar>
            <rsrvr_hgt>4</rsrvr_hgt>
            <rsrvr_len>174</rsrvr_len>
            <sncn_area>27</sncn_area>
            <bgncst_yr>1969</bgncst_yr>
            <cmcn_yr>1969</cmcn_yr>
            <cmptnc_inst_nm>오산시</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>110111</wtrsc_std_bsn_cd>
            <std_bsn_nm>오산천</std_bsn_nm>
        </item>
        <item>
            <rsrvr_nm>원1</rsrvr_nm>
            <drght_freq>1</drght_freq>
            <bsn_area>45</bsn_area>
            <vld_rscpt>30.1</vld_rscpt>
            <dm_frm>토언제중심점토형</dm_frm>
            <tot_area>10.5</tot_area>
            <ntiar>10.5</ntiar>
            <idrar/>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>주</wtrsrc_tool_mi>
            <addr>경기도 오산시 대원동 (원동)703-2번지</addr>
            <fwlvar>2.9</fwlvar>
            <rsrvr_hgt>8</rsrvr_hgt>
            <rsrvr_len>168</rsrvr_len>
            <sncn_area>14</sncn_area>
            <bgncst_yr>1964</bgncst_yr>
            <cmcn_yr>1964</cmcn_yr>
            <cmptnc_inst_nm>오산시</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>110111</wtrsc_std_bsn_cd>
            <std_bsn_nm>오산천</std_bsn_nm>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/waterUseFacility/pumpingStations

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
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

https://mulmoa.go.kr/api/v1/waterUseFacility/pumpingStations?apikey=APIKEY&type=1&admcd=41

요청결과 출력

결과 변수
변수명	설명	비고
pmpstn_nm	시설명
drght_freq	한발빈도
drar	유역면적
max_ppqty	최대 양수량
TOT_AREA	관개면적 계
ntiar	순관개면적
idrar	관배수면적
zone_excl_watsup_area	구역외급수면적
wtrsrc_tool_mi	수원공구분
emot_type	전동기종류
mtr_cntom	원동기 대수
mtr_hp	원동기 마력
pump_knd	펌프 종류
pump_dia	펌프 구경
sncn_area	인가면적
cmcn_yr	준공년도
addr	소재지
bgncst_yr	착공년도
cmptnc_inst_nm	관할기관
wtrsc_std_bsn_cd	표준유역코드
std_bsn_nm	표준유역명

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/waterUseFacility/pumpingStations';

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>551</count>
    <data/>
    <list>
        <item>
            <pmpstn_nm>하광교</pmpstn_nm>
            <drght_freq>1</drght_freq>
            <drar>106</drar>
            <max_ppqty>1</max_ppqty>
            <tot_area>3</tot_area>
            <ntiar>3</ntiar>
            <idrar/>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>보조</wtrsrc_tool_mi>
            <emot_type/>
            <mtr_cntom/>
            <mtr_hp/>
            <pump_knd/>
            <pump_dia/>
            <sncn_area/>
            <cmcn_yr>2001</cmcn_yr>
            <addr>경기도 수원시 장안구 연무동 (하광교동)440-1번지</addr>
            <bgncst_yr>2001</bgncst_yr>
            <cmptnc_inst_nm>수원시</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>110112</wtrsc_std_bsn_cd>
            <std_bsn_nm>황구지천상류</std_bsn_nm>
        </item>
        <item>
            <pmpstn_nm>신평리</pmpstn_nm>
            <drght_freq>1</drght_freq>
            <drar/>
            <max_ppqty>0.18</max_ppqty>
            <tot_area>54</tot_area>
            <ntiar>54</ntiar>
            <idrar/>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>주</wtrsrc_tool_mi>
            <emot_type/>
            <mtr_cntom>1</mtr_cntom>
            <mtr_hp>22</mtr_hp>
            <pump_knd/>
            <pump_dia/>
            <sncn_area>57</sncn_area>
            <cmcn_yr>2006</cmcn_yr>
            <addr>경기도 수원시 권선구 평동 (평리동)115-10번지</addr>
            <bgncst_yr>2006</bgncst_yr>
            <cmptnc_inst_nm>수원시</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>110112</wtrsc_std_bsn_cd>
            <std_bsn_nm>황구지천상류</std_bsn_nm>
        </item>
        <item>
            <pmpstn_nm>기배리</pmpstn_nm>
            <drght_freq>3</drght_freq>
            <drar/>
            <max_ppqty>0.1</max_ppqty>
            <tot_area>14</tot_area>
            <ntiar/>
            <idrar>14</idrar>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>보조</wtrsrc_tool_mi>
            <emot_type/>
            <mtr_cntom>1</mtr_cntom>
            <mtr_hp>15</mtr_hp>
            <pump_knd/>
            <pump_dia/>
            <sncn_area>55</sncn_area>
            <cmcn_yr>1977</cmcn_yr>
            <addr>경기도 수원시 권선구 평동 (고색동)615-6번지</addr>
            <bgncst_yr>1977</bgncst_yr>
            <cmptnc_inst_nm>수원시</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>110112</wtrsc_std_bsn_cd>
            <std_bsn_nm>황구지천상류</std_bsn_nm>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/waterUseFacility/drainageStations

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
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

https://mulmoa.go.kr/api/v1/waterUseFacility/drainageStations?apikey=APIKEY&type=1&admcd=41

요청결과 출력

결과 변수
변수명	설명	비고
pmpdrn_nm	시설명
drght_freq	한발빈도
bsn_area	유역면적
max_ppqty	최대 양수량
TOT_AREA	관개면적 계
ntiar	순관개면적
idrar	관배수면적
zone_excl_watsup_area	구역외급수면적
wtrsrc_tool_mi	수원공구분
emot_type	전동기종류
mtr_cntom	원동기 대수
mtr_hp	원동기 마력
pump_knd	펌프 종류
pump_dia	펌프 구경
sncn_area	인가면적
cmcn_yr	준공년도
addr	소재지
bgncst_yr	착공년도
cmptnc_inst_nm	관할기관
wtrsc_std_bsn_cd	표준유역코드
std_bsn_nm	표준유역명

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/waterUseFacility/drainageStations';

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>125</count>
    <data/>
    <list>
        <item>
            <pmpdrn_nm>장로포</pmpdrn_nm>
            <drght_freq>10</drght_freq>
            <bsn_area>950</bsn_area>
            <max_ppqty>2.5</max_ppqty>
            <tot_area>280</tot_area>
            <ntiar/>
            <idrar>280</idrar>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>보조</wtrsrc_tool_mi>
            <emot_type/>
            <mtr_cntom>2</mtr_cntom>
            <mtr_hp>75</mtr_hp>
            <pump_knd/>
            <pump_dia/>
            <sncn_area>280</sncn_area>
            <cmcn_yr>2009</cmcn_yr>
            <addr>부산광역시 강서구 대저1동 3135-02번지</addr>
            <bgncst_yr>2005</bgncst_yr>
            <cmptnc_inst_nm>김해.양산.부산지사</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>202207</wtrsc_std_bsn_cd>
            <std_bsn_nm/>
        </item>
        <item>
            <pmpdrn_nm>봉림</pmpdrn_nm>
            <drght_freq>10</drght_freq>
            <bsn_area>583.8</bsn_area>
            <max_ppqty>6.61</max_ppqty>
            <tot_area>382</tot_area>
            <ntiar/>
            <idrar>382</idrar>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>주</wtrsrc_tool_mi>
            <emot_type/>
            <mtr_cntom>3</mtr_cntom>
            <mtr_hp>150</mtr_hp>
            <pump_knd/>
            <pump_dia/>
            <sncn_area>583.7</sncn_area>
            <cmcn_yr>2003</cmcn_yr>
            <addr>부산광역시 강서구 가락동 (봉림동)201-05번지</addr>
            <bgncst_yr>2001</bgncst_yr>
            <cmptnc_inst_nm>김해.양산.부산지사</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>202206</wtrsc_std_bsn_cd>
            <std_bsn_nm/>
        </item>
        <item>
            <pmpdrn_nm>식만</pmpdrn_nm>
            <drght_freq>10</drght_freq>
            <bsn_area>1,421.7</bsn_area>
            <max_ppqty>4.5</max_ppqty>
            <tot_area>148</tot_area>
            <ntiar>148</ntiar>
            <idrar/>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>주</wtrsrc_tool_mi>
            <emot_type/>
            <mtr_cntom>3</mtr_cntom>
            <mtr_hp>93/112</mtr_hp>
            <pump_knd/>
            <pump_dia/>
            <sncn_area>1,421.7</sncn_area>
            <cmcn_yr>2005</cmcn_yr>
            <addr>부산광역시 강서구 가락동 (식만동)372번지</addr>
            <bgncst_yr>2004</bgncst_yr>
            <cmptnc_inst_nm>김해.양산.부산지사</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>202206</wtrsc_std_bsn_cd>
            <std_bsn_nm/>
        </item>
        <item>
            <pmpdrn_nm>금포</pmpdrn_nm>
            <drght_freq>10</drght_freq>
            <bsn_area>1,890</bsn_area>
            <max_ppqty>19</max_ppqty>
            <tot_area>142</tot_area>
            <ntiar/>
            <idrar>142</idrar>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>보조</wtrsrc_tool_mi>
            <emot_type/>
            <mtr_cntom>6</mtr_cntom>
            <mtr_hp>22/375</mtr_hp>
            <pump_knd/>
            <pump_dia/>
            <sncn_area>142</sncn_area>
            <cmcn_yr>1964</cmcn_yr>
            <addr>대구광역시 달성군 논공읍 금포리684-01번지</addr>
            <bgncst_yr>1959</bgncst_yr>
            <cmptnc_inst_nm>달성지사</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>201402</wtrsc_std_bsn_cd>
            <std_bsn_nm/>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/waterUseFacility/intakeWeirs

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
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

https://mulmoa.go.kr/api/v1/waterUseFacility/intakeWeirs?apikey=APIKEY&type=1&admcd=41

요청결과 출력

결과 변수
변수명	설명	비고
weir_nm	시설명
drght_freq	한발빈도
drar	유역면적
witqty	취수량
sncn_area	인가면적
TOT_AREA	관개면적 계
ntiar	순관개면적
idrar	관배수면적
zone_excl_watsup_area	구역외급수면적
wtrsrc_tool_mi	수원공구분
addr	소재지
intkweir_hgt	높이
intkweir_len	길이
intkweir_strct	구조
cmcn_yr	준공년도
cmptnc_inst_nm	관할기관
wtrsc_std_bsn_cd	표준유역코드
std_bsn_nm	표준유역명

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/waterUseFacility/intakeWeirs';

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>1049</count>
    <data/>
    <list>
        <item>
            <weir_nm>곳집말</weir_nm>
            <drght_freq>1</drght_freq>
            <drar/>
            <witqty>0.08</witqty>
            <sncn_area>29</sncn_area>
            <tot_area>17</tot_area>
            <ntiar>17</ntiar>
            <idrar/>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>주</wtrsrc_tool_mi>
            <addr>경기도 수원시 권선구 평동 (오목천동)</addr>
            <intkweir_hgt>1</intkweir_hgt>
            <intkweir_len>20</intkweir_len>
            <intkweir_strct>콘크리트</intkweir_strct>
            <cmcn_yr>1976</cmcn_yr>
            <cmptnc_inst_nm>수원시</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>110112</wtrsc_std_bsn_cd>
            <std_bsn_nm>황구지천상류</std_bsn_nm>
        </item>
        <item>
            <weir_nm>탑리</weir_nm>
            <drght_freq>1</drght_freq>
            <drar>3,155</drar>
            <witqty>0.14</witqty>
            <sncn_area>53</sncn_area>
            <tot_area>53</tot_area>
            <ntiar>53</ntiar>
            <idrar/>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>부속</wtrsrc_tool_mi>
            <addr>경기도 수원시 권선구 평동 (고색동)896-10번지</addr>
            <intkweir_hgt>2.2</intkweir_hgt>
            <intkweir_len>33</intkweir_len>
            <intkweir_strct>콘크리트</intkweir_strct>
            <cmcn_yr>1964</cmcn_yr>
            <cmptnc_inst_nm>화성.수원지사</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>110112</wtrsc_std_bsn_cd>
            <std_bsn_nm>황구지천상류</std_bsn_nm>
        </item>
        <item>
            <weir_nm>기배리</weir_nm>
            <drght_freq>1</drght_freq>
            <drar/>
            <witqty>0.09</witqty>
            <sncn_area>57</sncn_area>
            <tot_area>57</tot_area>
            <ntiar>57</ntiar>
            <idrar/>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>보조</wtrsrc_tool_mi>
            <addr>경기도 수원시 권선구 평동 (고색동)614번지</addr>
            <intkweir_hgt>1.4</intkweir_hgt>
            <intkweir_len>32</intkweir_len>
            <intkweir_strct>콘크리트</intkweir_strct>
            <cmcn_yr>2006</cmcn_yr>
            <cmptnc_inst_nm>수원시</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>110112</wtrsc_std_bsn_cd>
            <std_bsn_nm>황구지천상류</std_bsn_nm>
        </item>
        <item>
            <weir_nm>서둔</weir_nm>
            <drght_freq>3</drght_freq>
            <drar/>
            <witqty>0.05</witqty>
            <sncn_area>48</sncn_area>
            <tot_area>21</tot_area>
            <ntiar>21</ntiar>
            <idrar/>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>주</wtrsrc_tool_mi>
            <addr>경기도 수원시 권선구 서둔동 </addr>
            <intkweir_hgt>1</intkweir_hgt>
            <intkweir_len>34</intkweir_len>
            <intkweir_strct>콘크리트</intkweir_strct>
            <cmcn_yr>1945</cmcn_yr>
            <cmptnc_inst_nm>수원시</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>110112</wtrsc_std_bsn_cd>
            <std_bsn_nm>황구지천상류</std_bsn_nm>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/waterUseFacility/culverts

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
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

https://mulmoa.go.kr/api/v1/waterUseFacility/culverts?apikey=APIKEY&type=1&admcd=41

요청결과 출력

결과 변수
변수명	설명	비고
iflglr_nm	시설명
drght_freq	한발빈도
bsn_area	유역면적
witqty	취수량
sncn_area	인가면적
TOT_AREA	관개면적 계
ntiar	순관개면적
idrar	관배수면적
zone_excl_watsup_area	구역외급수면적
wtrsrc_tool_mi	수원공구분
addr	소재지
cmcn_yr	준공년도
cmptnc_inst_nm	관할기관
wtrsc_std_bsn_cd	표준유역코드
std_bsn_nm	표준유역명

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/waterUseFacility/culverts';

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>278</count>
    <data/>
    <list>
        <item>
            <iflglr_nm>내천</iflglr_nm>
            <drght_freq>10</drght_freq>
            <bsn_area/>
            <witqty/>
            <sncn_area>10</sncn_area>
            <tot_area>6</tot_area>
            <ntiar>6</ntiar>
            <idrar/>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>보조</wtrsrc_tool_mi>
            <addr>경기도 평택시 서탄면 내천리</addr>
            <cmcn_yr>1970</cmcn_yr>
            <cmptnc_inst_nm>평택시</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>110114</wtrsc_std_bsn_cd>
            <std_bsn_nm>동연교수위표</std_bsn_nm>
        </item>
        <item>
            <iflglr_nm>유천</iflglr_nm>
            <drght_freq>5</drght_freq>
            <bsn_area>35,740</bsn_area>
            <witqty>14,160</witqty>
            <sncn_area>140</sncn_area>
            <tot_area>140</tot_area>
            <ntiar>140</ntiar>
            <idrar/>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>보조</wtrsrc_tool_mi>
            <addr>경기도 평택시 신평동 (유천동)153-03번지</addr>
            <cmcn_yr>1973</cmcn_yr>
            <cmptnc_inst_nm>안성지사</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>110107</wtrsc_std_bsn_cd>
            <std_bsn_nm>평택수위표</std_bsn_nm>
        </item>
        <item>
            <iflglr_nm>원곡</iflglr_nm>
            <drght_freq>10</drght_freq>
            <bsn_area/>
            <witqty>7,200</witqty>
            <sncn_area>49</sncn_area>
            <tot_area>49</tot_area>
            <ntiar>49</ntiar>
            <idrar/>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>보조</wtrsrc_tool_mi>
            <addr>경기도 평택시 비전1동 (청룡동)101-8번지</addr>
            <cmcn_yr>1983</cmcn_yr>
            <cmptnc_inst_nm>안성지사</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>110108</wtrsc_std_bsn_cd>
            <std_bsn_nm>진위천합류전</std_bsn_nm>
        </item>
        <item>
            <iflglr_nm>칠원</iflglr_nm>
            <drght_freq>7</drght_freq>
            <bsn_area/>
            <witqty>2,754</witqty>
            <sncn_area>24.2</sncn_area>
            <tot_area>12</tot_area>
            <ntiar>12</ntiar>
            <idrar/>
            <zone_excl_watsup_area/>
            <wtrsrc_tool_mi>보조</wtrsrc_tool_mi>
            <addr>경기도 평택시 동삭동 (칠원동)</addr>
            <cmcn_yr>1977</cmcn_yr>
            <cmptnc_inst_nm>평택시</cmptnc_inst_nm>
            <wtrsc_std_bsn_cd>110108</wtrsc_std_bsn_cd>
            <std_bsn_nm>진위천합류전</std_bsn_nm>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/waterUseFacility/wells

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
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

https://mulmoa.go.kr/api/v1/waterUseFacility/wells?apikey=APIKEY&type=1&admcd=41

요청결과 출력

결과 변수
변수명	설명	비고
gwel_nm	관정명
drght_freq	가뭄빈도
addr	소재지
witqty	취수량
wtrsrc_tool_mi	수원공구분
cmcn_yr	준공년도
cmptnc_inst_nm	관할기관명
rmwsn	관련주수원공
wtrsc_std_bsn_cd	표준유역코드
std_bsn_nm	표준유역명

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/waterUseFacility/wells';

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>3372</count>
    <data/>
    <list>
        <item>
            <gwel_nm>이목</gwel_nm>
            <drght_freq>1</drght_freq>
            <addr>경기도 수원시 장안구 파장동 (이목동)</addr>
            <witqty>144</witqty>
            <wtrsrc_tool_mi>주</wtrsrc_tool_mi>
            <cmcn_yr>2002</cmcn_yr>
            <cmptnc_inst_nm>수원시</cmptnc_inst_nm>
            <rmwsn/>
            <wtrsc_std_bsn_cd>110112</wtrsc_std_bsn_cd>
            <std_bsn_nm>황구지천상류</std_bsn_nm>
        </item>
        <item>
            <gwel_nm>이목</gwel_nm>
            <drght_freq>1</drght_freq>
            <addr>경기도 수원시 장안구 파장동 (이목동)</addr>
            <witqty>160</witqty>
            <wtrsrc_tool_mi>보조</wtrsrc_tool_mi>
            <cmcn_yr>2001</cmcn_yr>
            <cmptnc_inst_nm>수원시</cmptnc_inst_nm>
            <rmwsn/>
            <wtrsc_std_bsn_cd>110112</wtrsc_std_bsn_cd>
            <std_bsn_nm>황구지천상류</std_bsn_nm>
        </item>
        <item>
            <gwel_nm>상광교</gwel_nm>
            <drght_freq>1</drght_freq>
            <addr>경기도 수원시 장안구 연무동 (상광교동)</addr>
            <witqty>170</witqty>
            <wtrsrc_tool_mi>주</wtrsrc_tool_mi>
            <cmcn_yr>2001</cmcn_yr>
            <cmptnc_inst_nm>수원시</cmptnc_inst_nm>
            <rmwsn/>
            <wtrsc_std_bsn_cd>110112</wtrsc_std_bsn_cd>
            <std_bsn_nm>황구지천상류</std_bsn_nm>
        </item>
        <item>
            <gwel_nm>오목천1</gwel_nm>
            <drght_freq>1</drght_freq>
            <addr>경기도 수원시 권선구 평동 (오목천동)168-02번지</addr>
            <witqty>145</witqty>
            <wtrsrc_tool_mi>보조</wtrsrc_tool_mi>
            <cmcn_yr>2001</cmcn_yr>
            <cmptnc_inst_nm>화성.수원지사</cmptnc_inst_nm>
            <rmwsn/>
            <wtrsc_std_bsn_cd>110112</wtrsc_std_bsn_cd>
            <std_bsn_nm>황구지천상류</std_bsn_nm>
        </item>
        <item>
            <gwel_nm>세류1</gwel_nm>
            <drght_freq>1</drght_freq>
            <addr>경기도 수원시 권선구 평동 105-07번지</addr>
            <witqty>140</witqty>
            <wtrsrc_tool_mi>보조</wtrsrc_tool_mi>
            <cmcn_yr>2001</cmcn_yr>
            <cmptnc_inst_nm>화성.수원지사</cmptnc_inst_nm>
            <rmwsn/>
            <wtrsc_std_bsn_cd>110112</wtrsc_std_bsn_cd>
            <std_bsn_nm>황구지천상류</std_bsn_nm>
        </item>
    </list>
</response>

오픈 API 서비스

물환경측정망

수질 및 수생태계 환경기준

녹조(조류) 정보

수질오염총량 관리제도

비점오염원

농업용 수리시설

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

검색필터

검색 대상

결과 내 재검색