용수이용량

사용 설명

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

요청 URL

https://mulmoa.go.kr/api/v1/waterUse/waterUsageIn

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
include	필수	구분	Y : 유효우량 포함 N : 유효우량 미포함
type	필수	구분	1 : 행정구역 2 : 권역
bsncd	선택	대권역	10 : 한강 11 : 안성천 12 : 한강서해 13 : 한강동해 20 : 낙동강 21 : 형산강 22 : 태화강 23 : 회야수영 24 : 낙동강동해 25 : 낙동강남해 30 : 금강 31 : 삽교천 32 : 금강서해 33 : 만경동진 40 : 섬진강 41 : 섬진강남해 50 : 영산강 51 : 탐진강 52 : 영산강남해 53 : 영산강서해 60 : 제주도
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/waterUse/waterUsageIn?apikey=APIKEY&include=Y&type=1

요청결과 출력

결과 변수
변수명	설명	비고
YR	년도
USWTRUTQTYSUMN	합계(유효우량 미포함)
USWTRUTQTYSUMY	합계(유효우량 포함)
WSSUM	생활용수 이용량
IWTR	공업용수 이용량
AGRCLTUSWTRN	농업용수 이용량(유효우량 미포함)
AGRCLTUSWTRY	농업용수 이용량(유효우량 포함)

오류코드 설명

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

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>59</count>
    <data/>
    <list>
        <item>
            <row_number>1</row_number>
            <yr>2023</yr>
            <uswtrutqtysumn>19,133,901</uswtrutqtysumn>
            <uswtrutqtysumy>19,133,901</uswtrutqtysumy>
            <wssum>18,358,931</wssum>
            <iwtr>774,970</iwtr>
            <agrcltuswtrn>0</agrcltuswtrn>
            <agrcltuswtry>0</agrcltuswtry>
        </item>
        <item>
            <row_number>2</row_number>
            <yr>2022</yr>
            <uswtrutqtysumn>27,963,641</uswtrutqtysumn>
            <uswtrutqtysumy>34,728,725.6</uswtrutqtysumy>
            <wssum>18,421,715</wssum>
            <iwtr>1,143,941.5</iwtr>
            <agrcltuswtrn>8,397,984.5</agrcltuswtrn>
            <agrcltuswtry>15,163,069.1</agrcltuswtry>
        </item>
        <item>
            <row_number>3</row_number>
            <yr>2021</yr>
            <uswtrutqtysumn>27,730,405.8</uswtrutqtysumn>
            <uswtrutqtysumy>34,876,919.6</uswtrutqtysumy>
            <wssum>18,317,832</wssum>
            <iwtr>594,440.1</iwtr>
            <agrcltuswtrn>8,818,133.7</agrcltuswtrn>
            <agrcltuswtry>15,964,647.5</agrcltuswtry>
        </item>
        <item>
            <row_number>4</row_number>
            <yr>2020</yr>
            <uswtrutqtysumn>97,333,160</uswtrutqtysumn>
            <uswtrutqtysumy>106,185,599.4</uswtrutqtysumy>
            <wssum>88,968,251</wssum>
            <iwtr>2,112,118.7</iwtr>
            <agrcltuswtrn>6,252,790.3</agrcltuswtrn>
            <agrcltuswtry>15,105,229.7</agrcltuswtry>
        </item>
        <item>
            <row_number>5</row_number>
            <yr>2019</yr>
            <uswtrutqtysumn>31,605,538.5</uswtrutqtysumn>
            <uswtrutqtysumy>38,138,315.5</uswtrutqtysumy>
            <wssum>18,127,217</wssum>
            <iwtr>2,347,018.7</iwtr>
            <agrcltuswtrn>11,131,302.8</agrcltuswtrn>
            <agrcltuswtry>17,664,079.8</agrcltuswtry>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/waterUse/domestic

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
type	필수	구분	1 : 행정구역 2 : 권역
bsncd	선택	대권역	10 : 한강 11 : 안성천 12 : 한강서해 13 : 한강동해 20 : 낙동강 21 : 형산강 22 : 태화강 23 : 회야수영 24 : 낙동강동해 25 : 낙동강남해 30 : 금강 31 : 삽교천 32 : 금강서해 33 : 만경동진 40 : 섬진강 41 : 섬진강남해 50 : 영산강 51 : 탐진강 52 : 영산강남해 53 : 영산강서해 60 : 제주도
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/waterUse/domestic?apikey=APIKEY&type=1&admcd=41

요청결과 출력

결과 변수
변수명	설명	비고
yr	년도
wtspl_usqty	상수도이용량
nwsply_rgn_uswtr_utqty	미급수지역이용량
etc_uswqty	기타이용량

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/waterUse/domestic';

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>59</count>
    <data/>
    <list>
        <item>
            <yr>2023</yr>
            <wtspl_usqty>18275485.000</wtspl_usqty>
            <nwsply_rgn_uswtr_utqty>62133.000</nwsply_rgn_uswtr_utqty>
            <etc_usqty>2625.000</etc_usqty>
        </item>
        <item>
            <yr>2022</yr>
            <wtspl_usqty>18333822.000</wtspl_usqty>
            <nwsply_rgn_uswtr_utqty>65928.000</nwsply_rgn_uswtr_utqty>
            <etc_usqty>2625.000</etc_usqty>
        </item>
        <item>
            <yr>2021</yr>
            <wtspl_usqty>18225976.000</wtspl_usqty>
            <nwsply_rgn_uswtr_utqty>72135.000</nwsply_rgn_uswtr_utqty>
            <etc_usqty>2628.000</etc_usqty>
        </item>
        <item>
            <yr>2020</yr>
            <wtspl_usqty>17943734.000</wtspl_usqty>
            <nwsply_rgn_uswtr_utqty>71002245.000</nwsply_rgn_uswtr_utqty>
            <etc_usqty>3350.000</etc_usqty>
        </item>
        <item>
            <yr>2019</yr>
            <wtspl_usqty>17983752.000</wtspl_usqty>
            <nwsply_rgn_uswtr_utqty>80598.000</nwsply_rgn_uswtr_utqty>
            <etc_usqty>18659.000</etc_usqty>
        </item>
        <item>
            <yr>2018</yr>
            <wtspl_usqty>32856405.000</wtspl_usqty>
            <nwsply_rgn_uswtr_utqty>180278.000</nwsply_rgn_uswtr_utqty>
            <etc_usqty>42412.000</etc_usqty>
        </item>
        <item>
            <yr>2017</yr>
            <wtspl_usqty>17508199.000</wtspl_usqty>
            <nwsply_rgn_uswtr_utqty>103657.000</nwsply_rgn_uswtr_utqty>
            <etc_usqty>3778.000</etc_usqty>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/waterUse/industrial

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
type	필수	구분	1 : 행정구역 2 : 권역
bsncd	선택	대권역	10 : 한강 11 : 안성천 12 : 한강서해 13 : 한강동해 20 : 낙동강 21 : 형산강 22 : 태화강 23 : 회야수영 24 : 낙동강동해 25 : 낙동강남해 30 : 금강 31 : 삽교천 32 : 금강서해 33 : 만경동진 40 : 섬진강 41 : 섬진강남해 50 : 영산강 51 : 탐진강 52 : 영산강남해 53 : 영산강서해 60 : 제주도
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/waterUse/industrial?apikey=APIKEY&type=1

요청결과 출력

결과 변수
변수명	설명	비고
YR	년도
TSM_VAL	계(계획입지공단 용수이용량 + 자유입지업체 이용량 계)
TSM_USWTR_UTQTY	계획입지공단 용수이용량	천㎥/년
UTQTY_TSM	자유입지업체 이용량 계	천㎥/년
RWTR_UTQTY	자유입지업체_하천수이용량	천㎥/년
UGWTR_UTQTY	자유입지업체_지하수이용량	천㎥/년

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/waterUse/industrial';

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>59</count>
    <data/>
    <list>
        <item>
            <yr>2023</yr>
            <tsm_val>774970.0000</tsm_val>
            <tsm_uswtr_utqty>0</tsm_uswtr_utqty>
            <utqty_tsm>774970.0000</utqty_tsm>
            <rwtr_utqty>653179.700</rwtr_utqty>
            <ugwtr_utqty>121790.300</ugwtr_utqty>
        </item>
        <item>
            <yr>2022</yr>
            <tsm_val>1143941.5000</tsm_val>
            <tsm_uswtr_utqty>0</tsm_uswtr_utqty>
            <utqty_tsm>1143941.5000</utqty_tsm>
            <rwtr_utqty>1022828.300</rwtr_utqty>
            <ugwtr_utqty>121112.400</ugwtr_utqty>
        </item>
        <item>
            <yr>2021</yr>
            <tsm_val>594440.1000</tsm_val>
            <tsm_uswtr_utqty>0</tsm_uswtr_utqty>
            <utqty_tsm>594440.1000</utqty_tsm>
            <rwtr_utqty>477262.600</rwtr_utqty>
            <ugwtr_utqty>117177.200</ugwtr_utqty>
        </item>
        <item>
            <yr>2020</yr>
            <tsm_val>2112118.7000</tsm_val>
            <tsm_uswtr_utqty>1609476.000</tsm_uswtr_utqty>
            <utqty_tsm>502642.7000</utqty_tsm>
            <rwtr_utqty>377746.500</rwtr_utqty>
            <ugwtr_utqty>124896.200</ugwtr_utqty>
        </item>
        <item>
            <yr>2019</yr>
            <tsm_val>2347018.7000</tsm_val>
            <tsm_uswtr_utqty>1791787.100</tsm_uswtr_utqty>
            <utqty_tsm>555231.6000</utqty_tsm>
            <rwtr_utqty>430911.300</rwtr_utqty>
            <ugwtr_utqty>124320.200</ugwtr_utqty>
        </item>
        <item>
            <yr>2018</yr>
            <tsm_val>2946523.4000</tsm_val>
            <tsm_uswtr_utqty>1812113.200</tsm_uswtr_utqty>
            <utqty_tsm>1134410.2000</utqty_tsm>
            <rwtr_utqty>878730.400</rwtr_utqty>
            <ugwtr_utqty>255679.800</ugwtr_utqty>
        </item>
        <item>
            <yr>2017</yr>
            <tsm_val>2473963.7000</tsm_val>
            <tsm_uswtr_utqty>1754269.000</tsm_uswtr_utqty>
            <utqty_tsm>719694.7000</utqty_tsm>
            <rwtr_utqty>593169.900</rwtr_utqty>
            <ugwtr_utqty>126524.800</ugwtr_utqty>
        </item>
        <item>
            <yr>2016</yr>
            <tsm_val>2725352.0000</tsm_val>
            <tsm_uswtr_utqty>1759759.000</tsm_uswtr_utqty>
            <utqty_tsm>965593.0000</utqty_tsm>
            <rwtr_utqty>843343.000</rwtr_utqty>
            <ugwtr_utqty>122249.000</ugwtr_utqty>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/waterUse/agriculturalIn

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
include	필수	구분	Y : 유효우량 포함 N : 유효우량 미포함
type	필수	구분	1 : 행정구역 2 : 권역
bsncd	선택	대권역	10 : 한강 11 : 안성천 12 : 한강서해 13 : 한강동해 20 : 낙동강 21 : 형산강 22 : 태화강 23 : 회야수영 24 : 낙동강동해 25 : 낙동강남해 30 : 금강 31 : 삽교천 32 : 금강서해 33 : 만경동진 40 : 섬진강 41 : 섬진강남해 50 : 영산강 51 : 탐진강 52 : 영산강남해 53 : 영산강서해 60 : 제주도
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/waterUse/agriculturalIn?apikey=APIKEY&include=Y&type=1

요청결과 출력

결과 변수
변수명	설명	비고
yr	년도
Paddy	논용수
Dry	밭용수
Livestock	축산용수

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/waterUse/agriculturalIn';

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>58</count>
    <data/>
    <list>
        <item>
            <yr>2022</yr>
            <paddy>10732408.500</paddy>
            <dry>4097780.600</dry>
            <livestock>332880.000</livestock>
        </item>
        <item>
            <yr>2021</yr>
            <paddy>11579322.500</paddy>
            <dry>4052338.800</dry>
            <livestock>332986.200</livestock>
        </item>
        <item>
            <yr>2020</yr>
            <paddy>11054227.200</paddy>
            <dry>3723557.000</dry>
            <livestock>327445.500</livestock>
        </item>
        <item>
            <yr>2019</yr>
            <paddy>13271265.900</paddy>
            <dry>4073786.600</dry>
            <livestock>319027.300</livestock>
        </item>
        <item>
            <yr>2018</yr>
            <paddy>11833350.500</paddy>
            <dry>3866527.100</dry>
            <livestock>642144.200</livestock>
        </item>
        <item>
            <yr>2017</yr>
            <paddy>12751198.700</paddy>
            <dry>3770661.400</dry>
            <livestock>316968.600</livestock>
        </item>
        <item>
            <yr>2016</yr>
            <paddy>14232777.100</paddy>
            <dry>3634860.900</dry>
            <livestock>299838.300</livestock>
        </item>
        <item>
            <yr>2015</yr>
            <paddy>14322121.900</paddy>
            <dry>5656565.000</dry>
            <livestock>279091.000</livestock>
        </item>
    </list>
</response>

오픈 API 서비스

물환경측정망

수질 및 수생태계 환경기준

녹조(조류) 정보

수질오염총량 관리제도

비점오염원

용수이용량

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

검색필터

검색 대상

결과 내 재검색