광역·지방상수도 시설

사용 설명

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

요청 URL

https://mulmoa.go.kr/api/v1/waterWorksFacility/industrialIntake

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
infra	필수	시설	1 : 공업용수도 2: 지방상수도
type	필수	구분	1 : 행정구역 2 : 권역
bsncd	선택	권역 코드	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	선택	출력 포맷

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

샘플 URL

https://mulmoa.go.kr/api/v1/waterWorksFacility/industrialIntake?apikey=APIKEY&infra=1&type=1

요청결과 출력

결과 변수
변수명	설명	비고
location	장소
FCLT_NM	시설명
ADDR	위치
FCLT_CPCT	시설용량
WTRSRC_KND	수원종류
RVR_NM	하천명
WTRSC_STD_BSN_CD	수자원표준유역코드
CMCN_YR	준공년도
USG	용도
AFTR_FCLT	후시설
SPLY_RGN	공급지역

오류코드 설명

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

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>
            <fclt_nm>자양</fclt_nm>
            <addr>서울특별시 광진구 구의동 573번지</addr>
            <fclt_cpct>250,000</fclt_cpct>
            <wtrsrc_knd>표류수</wtrsrc_knd>
            <rvr_nm>한강</rvr_nm>
            <location>중랑천합류전</location>
            <wtrsc_std_bsn_cd>101807</wtrsc_std_bsn_cd>
            <cmcn_yr>1993</cmcn_yr>
            <usg>생활용</usg>
            <aftr_fclt>일산정수장</aftr_fclt>
            <sply_rgn>고양(덕양구,일산동구,일산서구)</sply_rgn>
        </item>
        <item>
            <row_number>2</row_number>
            <fclt_nm>영등포</fclt_nm>
            <addr>서울특별시 영등포구 양평2동 양화동156-5(노들로11)</addr>
            <fclt_cpct>130,000</fclt_cpct>
            <wtrsrc_knd>표류수</wtrsrc_knd>
            <rvr_nm>한강</rvr_nm>
            <location>안양천하류</location>
            <wtrsc_std_bsn_cd>101816</wtrsc_std_bsn_cd>
            <cmcn_yr>1969</cmcn_yr>
            <usg>공업용</usg>
            <aftr_fclt>영등포_공업</aftr_fclt>
            <sply_rgn>서울(롯데제과,수화기업,제일제당)</sply_rgn>
        </item>
        <item>
            <row_number>3</row_number>
            <fclt_nm>죽곡</fclt_nm>
            <addr>대구광역시 달성군 다사읍 죽곡리642-4번지</addr>
            <fclt_cpct>210,000</fclt_cpct>
            <wtrsrc_knd>표류수</wtrsrc_knd>
            <rvr_nm>낙동강</rvr_nm>
            <location>강정고령보</location>
            <wtrsc_std_bsn_cd>201108</wtrsc_std_bsn_cd>
            <cmcn_yr>1996</cmcn_yr>
            <usg>공업용</usg>
            <aftr_fclt>죽곡_공업</aftr_fclt>
            <sply_rgn>대구염색산단,대구출판산단,서대구산단,성서1차산단</sply_rgn>
        </item>
        <item>
            <row_number>4</row_number>
            <fclt_nm>대암_선암</fclt_nm>
            <addr>울산광역시 울주군 언양읍 구수리386-8번지</addr>
            <fclt_cpct>50,000</fclt_cpct>
            <wtrsrc_knd>호소수</wtrsrc_knd>
            <rvr_nm>대암댐/선암댐</rvr_nm>
            <location>대암댐</location>
            <wtrsc_std_bsn_cd>220102</wtrsc_std_bsn_cd>
            <cmcn_yr>1969</cmcn_yr>
            <usg>생활용,공업용</usg>
            <aftr_fclt>선암댐,천상정수장(예비)</aftr_fclt>
            <sply_rgn>울산(북구,울주군)</sply_rgn>
        </item>
        <item>
            <row_number>5</row_number>
            <fclt_nm>대곡_사연</fclt_nm>
            <addr>울산광역시 울주군 두동면 천전리1210-64번지</addr>
            <fclt_cpct>220,000</fclt_cpct>
            <wtrsrc_knd>호소수</wtrsrc_knd>
            <rvr_nm>대곡댐/사연댐</rvr_nm>
            <location>사연댐</location>
            <wtrsc_std_bsn_cd>220103</wtrsc_std_bsn_cd>
            <cmcn_yr>2005</cmcn_yr>
            <usg>생활용,공업용</usg>
            <aftr_fclt>천상정수장</aftr_fclt>
            <sply_rgn>울산(북구,울주군,중구)</sply_rgn>
        </item>
        <item>
            <row_number>6</row_number>
            <fclt_nm>덕소</fclt_nm>
            <addr>경기도 남양주시 와부읍 도곡리489-1번지</addr>
            <fclt_cpct>475,000</fclt_cpct>
            <wtrsrc_knd>표류수</wtrsrc_knd>
            <rvr_nm>한강</rvr_nm>
            <location>팔당댐하류</location>
            <wtrsc_std_bsn_cd>101801</wtrsc_std_bsn_cd>
            <cmcn_yr>1999</cmcn_yr>
            <usg>생활용</usg>
            <aftr_fclt>덕소정수장</aftr_fclt>
            <sply_rgn>남양주,동두천,양주,의정부,포천</sply_rgn>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/waterWorksFacility/industrialTreatment

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
infra	필수	시설	1 : 공업용수도 2: 지방상수도
type	필수	구분	1 : 행정구역 2 : 권역
bsncd	선택	권역 코드	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	선택	출력 포맷

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

샘플 URL

https://mulmoa.go.kr/api/v1/waterWorksFacility/industrialTreatment?apikey=APIKEY&infra=1&type=1

요청결과 출력

결과 변수
변수명	설명	비고
WTRSC_STD_BSN_NM	장소
FTTP_FCLT_ID	정수장시설아이디
FTTP_FCLT_SE	정수장시설구분
FCLT_NM	시설명
ADMDST_CD	행정구역코드
WTRSC_STD_BSN_CD	수자원표준유역코드
ADDR	주소
FCLT_CPCT	시설용량
CMCN_YR	준공년도
CLWR_FRM	정수형식
BFR_FCLT	전시설
AFTR_FCLT	후시설
SPLY_RGN	공급지역

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/waterWorksFacility/industrialTreatment';

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>62</count>
    <data/>
    <list>
        <item>
            <row_number>1</row_number>
            <fclt_nm>영등포_공업</fclt_nm>
            <addr>서울특별시 영등포구 양평2동 양화동156-5(노들로11)</addr>
            <fclt_cpct>130,000</fclt_cpct>
            <wtrsc_std_bsn_nm>안양천하류</wtrsc_std_bsn_nm>
            <wtrsc_std_bsn_cd>101816</wtrsc_std_bsn_cd>
            <cmcn_yr>1969</cmcn_yr>
            <clwr_frm>간이침전</clwr_frm>
            <bfr_fclt>영등포_공업</bfr_fclt>
            <aftr_fclt>직결</aftr_fclt>
            <sply_rgn>서울(롯데제과,수화기업,제일제당)</sply_rgn>
        </item>
        <item>
            <row_number>2</row_number>
            <fclt_nm>죽곡</fclt_nm>
            <addr>대구광역시 달성군 다사읍 죽곡리642(강정본길88)</addr>
            <fclt_cpct>200,000</fclt_cpct>
            <wtrsc_std_bsn_nm>강정고령보</wtrsc_std_bsn_nm>
            <wtrsc_std_bsn_cd>201108</wtrsc_std_bsn_cd>
            <cmcn_yr>1995</cmcn_yr>
            <clwr_frm>응집침전</clwr_frm>
            <bfr_fclt>강정-죽곡_공업</bfr_fclt>
            <aftr_fclt>직결</aftr_fclt>
            <sply_rgn>대구(달서구,달성군,서구)</sply_rgn>
        </item>
        <item>
            <row_number>3</row_number>
            <fclt_nm>온산</fclt_nm>
            <addr>울산광역시 울주군 온산읍 학남리52-1번지</addr>
            <fclt_cpct>341,000</fclt_cpct>
            <wtrsc_std_bsn_nm>청량천</wtrsc_std_bsn_nm>
            <wtrsc_std_bsn_cd>230101</wtrsc_std_bsn_cd>
            <cmcn_yr>1977</cmcn_yr>
            <clwr_frm>급속여과</clwr_frm>
            <bfr_fclt>원동(신,울산공2단계)</bfr_fclt>
            <aftr_fclt>울산(직결)</aftr_fclt>
            <sply_rgn>울산</sply_rgn>
        </item>
        <item>
            <row_number>4</row_number>
            <fclt_nm>성남</fclt_nm>
            <addr>경기도 성남시 수정구 시흥동 사송동512번지</addr>
            <fclt_cpct>786,000</fclt_cpct>
            <wtrsc_std_bsn_nm>성남수위표</wtrsc_std_bsn_nm>
            <wtrsc_std_bsn_cd>101805</wtrsc_std_bsn_cd>
            <cmcn_yr>1988</cmcn_yr>
            <clwr_frm>급속+고도</clwr_frm>
            <bfr_fclt>팔당2(수도권3,4)</bfr_fclt>
            <aftr_fclt>성남(분당1,분당3,사송,판교)\수원(연무,원천,이의)</aftr_fclt>
            <sply_rgn>성남,수원,안성,오산,용인,평택,화성</sply_rgn>
        </item>
        <item>
            <row_number>5</row_number>
            <fclt_nm>동두천_공업</fclt_nm>
            <addr>경기도 동두천시 소요동 (하봉암동155)</addr>
            <fclt_cpct>20,000</fclt_cpct>
            <wtrsc_std_bsn_nm>신천하류</wtrsc_std_bsn_nm>
            <wtrsc_std_bsn_cd>102213</wtrsc_std_bsn_cd>
            <cmcn_yr>2006</cmcn_yr>
            <clwr_frm>응집침전</clwr_frm>
            <bfr_fclt>연천_동두천생공</bfr_fclt>
            <aftr_fclt>공업</aftr_fclt>
            <sply_rgn>동두천산단,동두천2산단</sply_rgn>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/waterWorksFacility/industrialPumping

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
infra	필수	시설	1 : 공업용수도 2: 지방상수도
type	필수	구분	1 : 행정구역 2 : 권역
bsncd	선택	권역 코드	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	선택	출력 포맷

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

샘플 URL

https://mulmoa.go.kr/api/v1/waterWorksFacility/industrialPumping?apikey=APIKEY&infra=1&type=1

요청결과 출력

결과 변수
변수명	설명	비고
WTRSC_STD_BSN_NM	장소
BSTR_FCLT_ID	가압장시설아이디
FCLT_NM	시설명
ADMDST_CD	행정구역코드(동)
WTRSC_STD_BSN_CD	수자원표준유역코드
ADDR	주소
FCLT_CPCT	시설용량
hp	마력
CNTOM	대수
CMCN_YR	준공년도
BSTR_FRM	가압장형식
PHG	양정
BFR_FCLT	전시설
AFTR_FCLT	후시설

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/waterWorksFacility/industrialPumping';

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>80</count>
    <data/>
    <list>
        <item>
            <wtrsc_std_bsn_nm>경기도 남양주시 양정동</wtrsc_std_bsn_nm>
            <bstr_fclt_id>4136013000</bstr_fclt_id>
            <fclt_nm>미금(수도권3,4,5,6)</fclt_nm>
            <admdst_cd>41360540</admdst_cd>
            <wtrsc_std_bsn_cd>101801</wtrsc_std_bsn_cd>
            <addr>경기도 남양주시 일패동 869번지_일패로159</addr>
            <fclt_cpct>597000.0000</fclt_cpct>
            <hp>502.7,502.7,737.2,187.7</hp>
            <cntom>3,2,1,2</cntom>
            <cmcn_yr>1988</cmcn_yr>
            <bstr_frm>양흡입볼류트</bstr_frm>
            <phg>67,64,64,67</phg>
            <bfr_fclt>와부,덕소(3,4,5,6,단계)</bfr_fclt>
            <aftr_fclt>가압장(낙양,의정부,양주)</aftr_fclt>
        </item>
        <item>
            <wtrsc_std_bsn_nm>경기도 안양시 만안구 박달2동</wtrsc_std_bsn_nm>
            <bstr_fclt_id>4117113000</bstr_fclt_id>
            <fclt_nm>안양(수도권3)</fclt_nm>
            <admdst_cd>41171630</admdst_cd>
            <wtrsc_std_bsn_cd>101815</wtrsc_std_bsn_cd>
            <addr>경기도 안양시 만안구 박달동 산78-4번지</addr>
            <fclt_cpct>100000.0000</fclt_cpct>
            <hp>402.1,154.1,402.1</hp>
            <cntom>1,1,3</cntom>
            <cmcn_yr>1989</cmcn_yr>
            <bstr_frm>양흡입볼류트</bstr_frm>
            <phg>33,33,33</phg>
            <bfr_fclt>팔당2(3단계)</bfr_fclt>
            <aftr_fclt>정수장(반월,안산)</aftr_fclt>
        </item>
        <item>
            <wtrsc_std_bsn_nm>경기도 용인시 기흥구 상하동</wtrsc_std_bsn_nm>
            <bstr_fclt_id>4146313000</bstr_fclt_id>
            <fclt_nm>용인(수도권3,4,5,6)</fclt_nm>
            <admdst_cd>41463586</admdst_cd>
            <wtrsc_std_bsn_cd>110110</wtrsc_std_bsn_cd>
            <addr>경기도 용인시 기흥구 상하동 469-5번지</addr>
            <fclt_cpct>56000.0000</fclt_cpct>
            <hp>335,335,335,335</hp>
            <cntom>4,2,2,1</cntom>
            <cmcn_yr>1999</cmcn_yr>
            <bstr_frm>양흡입볼류트</bstr_frm>
            <phg>97,97,97,102</phg>
            <bfr_fclt>성남정수장</bfr_fclt>
            <aftr_fclt>용인1,2배수지</aftr_fclt>
        </item>
        <item>
            <wtrsc_std_bsn_nm>경기도 의정부시 흥선동</wtrsc_std_bsn_nm>
            <bstr_fclt_id>4115013001</bstr_fclt_id>
            <fclt_nm>의정부(수도권5,6)</fclt_nm>
            <admdst_cd>41150615</admdst_cd>
            <wtrsc_std_bsn_cd>101808</wtrsc_std_bsn_cd>
            <addr>경기도 의정부시 가능동 231-117번지</addr>
            <fclt_cpct>186000.0000</fclt_cpct>
            <hp>871.3,469.1</hp>
            <cntom>4,2</cntom>
            <cmcn_yr>1999</cmcn_yr>
            <bstr_frm>양흡입볼류트</bstr_frm>
            <phg>75,75</phg>
            <bfr_fclt>미금가압장</bfr_fclt>
            <aftr_fclt>의정부시</aftr_fclt>
        </item>
        <item>
            <wtrsc_std_bsn_nm>경기도 성남시 분당구 판교동</wtrsc_std_bsn_nm>
            <bstr_fclt_id>4113513000</bstr_fclt_id>
            <fclt_nm>판교(수도권5,6)</fclt_nm>
            <admdst_cd>41135650</admdst_cd>
            <wtrsc_std_bsn_cd>101805</wtrsc_std_bsn_cd>
            <addr>경기도 성남시 분당구 판교동 655번지</addr>
            <fclt_cpct>3150000.0000</fclt_cpct>
            <hp>2200,470,1750</hp>
            <cntom>11,1,9</cntom>
            <cmcn_yr>1999</cmcn_yr>
            <bstr_frm>양흡입볼류트</bstr_frm>
            <phg>78,33,33</phg>
            <bfr_fclt>팔당3(5,6단계)</bfr_fclt>
            <aftr_fclt>정수장(수지,연성, 까치울,수산)가압장(청계)</aftr_fclt>
        </item>
        <item>
            <wtrsc_std_bsn_nm>경기도 의정부시 송산2동</wtrsc_std_bsn_nm>
            <bstr_fclt_id>4115013000</bstr_fclt_id>
            <fclt_nm>낙양(수도권5)</fclt_nm>
            <admdst_cd>41150576</admdst_cd>
            <wtrsc_std_bsn_cd>101808</wtrsc_std_bsn_cd>
            <addr>경기도 의정부시 낙양동 623-12번지</addr>
            <fclt_cpct>152000.0000</fclt_cpct>
            <hp>630,898.1</hp>
            <cntom>2,3</cntom>
            <cmcn_yr>2008</cmcn_yr>
            <bstr_frm>양흡입볼류트</bstr_frm>
            <phg>98,102</phg>
            <bfr_fclt>미금가압장</bfr_fclt>
            <aftr_fclt>포천시</aftr_fclt>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/waterWorksFacility/localReservoirs

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
type	필수	구분	1 : 행정구역 2 : 권역
bsncd	선택	권역 코드	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	선택	출력 포맷

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

샘플 URL

https://mulmoa.go.kr/api/v1/waterWorksFacility/localReservoirs?apikey=APIKEY&type=1

요청결과 출력

결과 변수
변수명	설명	비고
WTRSC_STD_BSN_NM	장소
FCLT_NM	시설명
ADDR	위치
FCLT_CPCT	시설용량
AVG_WSVLM	평균급수량
MAX_WSVLM	최대급수량
WTRSC_STD_BSN_CD	수자원표준유역코드
ELVTN	표고
EMRGY_SPLY_PSBLTY_DAY	비상급수일수
CMCN_YR	준공년도
BFR_FCLT	전시설
AFTR_FCLT	후시설
WATSUP_RGN	급수지역

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/waterWorksFacility/localReservoirs';

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>2487</count>
    <data/>
    <list>
        <item>
            <row_number>1</row_number>
            <fclt_nm>경내</fclt_nm>
            <addr>서울특별시 종로구 사직동 (세종로)1번지</addr>
            <fclt_cpct>1,000</fclt_cpct>
            <avg_wsvlm>594.0000</avg_wsvlm>
            <max_wsvlm>666.0000</max_wsvlm>
            <wtrsc_std_bsn_nm>청계천</wtrsc_std_bsn_nm>
            <wtrsc_std_bsn_cd>101809</wtrsc_std_bsn_cd>
            <elvtn>120.000</elvtn>
            <emrgy_sply_psblty_day>18</emrgy_sply_psblty_day>
            <cmcn_yr>1989</cmcn_yr>
            <bfr_fclt>1차배수지->부속배수지</bfr_fclt>
            <aftr_fclt/>
            <watsup_rgn>수용가</watsup_rgn>
        </item>
        <item>
            <row_number>2</row_number>
            <fclt_nm>가회</fclt_nm>
            <addr>서울특별시 종로구 삼청동 (삼청동)산2-1번지</addr>
            <fclt_cpct>1,000</fclt_cpct>
            <avg_wsvlm>2198.0000</avg_wsvlm>
            <max_wsvlm>2312.0000</max_wsvlm>
            <wtrsc_std_bsn_nm>청계천</wtrsc_std_bsn_nm>
            <wtrsc_std_bsn_cd>101809</wtrsc_std_bsn_cd>
            <elvtn>100.000</elvtn>
            <emrgy_sply_psblty_day>10</emrgy_sply_psblty_day>
            <cmcn_yr>2006</cmcn_yr>
            <bfr_fclt>1차배수지->부속배수지</bfr_fclt>
            <aftr_fclt/>
            <watsup_rgn>수용가</watsup_rgn>
        </item>
        <item>
            <row_number>3</row_number>
            <fclt_nm>평창1</fclt_nm>
            <addr>서울특별시 종로구 평창동 (평창동)491-3번지</addr>
            <fclt_cpct>1,600</fclt_cpct>
            <avg_wsvlm>1572.0000</avg_wsvlm>
            <max_wsvlm>1697.0000</max_wsvlm>
            <wtrsc_std_bsn_nm>청계천</wtrsc_std_bsn_nm>
            <wtrsc_std_bsn_cd>101809</wtrsc_std_bsn_cd>
            <elvtn>235.000</elvtn>
            <emrgy_sply_psblty_day>17</emrgy_sply_psblty_day>
            <cmcn_yr>1991</cmcn_yr>
            <bfr_fclt>1차배수지->부속배수지</bfr_fclt>
            <aftr_fclt/>
            <watsup_rgn>수용가</watsup_rgn>
        </item>
        <item>
            <row_number>4</row_number>
            <fclt_nm>무악</fclt_nm>
            <addr>서울특별시 종로구 무악동 (무악동)46-1910번지</addr>
            <fclt_cpct>1,000</fclt_cpct>
            <avg_wsvlm>1129.0000</avg_wsvlm>
            <max_wsvlm>1281.0000</max_wsvlm>
            <wtrsc_std_bsn_nm>청계천</wtrsc_std_bsn_nm>
            <wtrsc_std_bsn_cd>101809</wtrsc_std_bsn_cd>
            <elvtn>128.000</elvtn>
            <emrgy_sply_psblty_day>8</emrgy_sply_psblty_day>
            <cmcn_yr>1989</cmcn_yr>
            <bfr_fclt>1차배수지->부속배수지</bfr_fclt>
            <aftr_fclt/>
            <watsup_rgn>수용가</watsup_rgn>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/waterWorksFacility/privateSupply

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
type	필수	구분	1 : 행정구역 2 : 권역
bsncd	선택	권역 코드	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	선택	출력 포맷

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

샘플 URL

https://mulmoa.go.kr/api/v1/waterWorksFacility/privateSupply?apikey=APIKEY&type=1

요청결과 출력

결과 변수
변수명	설명	비고
FCLT_NM	시설명
ADDR	주소
wtrsc_std_bsn_cd	표준유역코드
std_bsn_nm	표준유역명
WTRSRC_KND	수원종류
WATSUP_PPLTN	급수인구
FCLT_CPCT	시설용량
PS_DAY_WSVLM	인당일급수량
SOLRD_CPCT	일사용량
CMCN_YR	준공연도

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/waterWorksFacility/privateSupply';

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>643</count>
    <data/>
    <list>
        <item>
            <fclt_nm>한일용평빌리지</fclt_nm>
            <addr>강원특별자치도 평창군 대관령면 솔봉로463-6번지</addr>
            <wtrsc_std_bsn_cd>100105</wtrsc_std_bsn_cd>
            <std_bsn_nm>도암댐</std_bsn_nm>
            <wtrsrc_knd>지하수</wtrsrc_knd>
            <watsup_ppltn>640</watsup_ppltn>
            <fclt_cpct>92.000</fclt_cpct>
            <ps_day_wsvlm>0.0000</ps_day_wsvlm>
            <solrd_cpct>92.0000</solrd_cpct>
            <cmcn_yr>2002</cmcn_yr>
        </item>
        <item>
            <fclt_nm>고성소망노인요양원</fclt_nm>
            <addr>강원특별자치도 고성군 거진읍 남강로650번지</addr>
            <wtrsc_std_bsn_cd>130102</wtrsc_std_bsn_cd>
            <std_bsn_nm>자산천</std_bsn_nm>
            <wtrsrc_knd>지하수</wtrsrc_knd>
            <watsup_ppltn>200</watsup_ppltn>
            <fclt_cpct>70.000</fclt_cpct>
            <ps_day_wsvlm>0.0000</ps_day_wsvlm>
            <solrd_cpct>20.0000</solrd_cpct>
            <cmcn_yr>2012</cmcn_yr>
        </item>
        <item>
            <fclt_nm>현대기아자동차천안연수원</fclt_nm>
            <addr>충청남도 천안시 동남구 병천면 (병천면)용두리406-1번지</addr>
            <wtrsc_std_bsn_cd>301112</wtrsc_std_bsn_cd>
            <std_bsn_nm>병천천하류</std_bsn_nm>
            <wtrsrc_knd>지하수</wtrsrc_knd>
            <watsup_ppltn/>
            <fclt_cpct>150.000</fclt_cpct>
            <ps_day_wsvlm/>
            <solrd_cpct/>
            <cmcn_yr>1996</cmcn_yr>
        </item>
        <item>
            <fclt_nm>천안골프클럽</fclt_nm>
            <addr>충청남도 천안시 서북구 성거읍 망향로870-24번지</addr>
            <wtrsc_std_bsn_cd>110105</wtrsc_std_bsn_cd>
            <std_bsn_nm>입장천</std_bsn_nm>
            <wtrsrc_knd>지하수</wtrsrc_knd>
            <watsup_ppltn>256</watsup_ppltn>
            <fclt_cpct>256.000</fclt_cpct>
            <ps_day_wsvlm>0.0000</ps_day_wsvlm>
            <solrd_cpct>34.0000</solrd_cpct>
            <cmcn_yr>1998</cmcn_yr>
        </item>
        <item>
            <fclt_nm>공주영상대학부설유치원</fclt_nm>
            <addr>충청남도 공주시 정안면 화봉평정길48번지</addr>
            <wtrsc_std_bsn_cd>301205</wtrsc_std_bsn_cd>
            <std_bsn_nm>공주보</std_bsn_nm>
            <wtrsrc_knd>지하수</wtrsrc_knd>
            <watsup_ppltn>160</watsup_ppltn>
            <fclt_cpct>40.000</fclt_cpct>
            <ps_day_wsvlm>0.0000</ps_day_wsvlm>
            <solrd_cpct>19.0000</solrd_cpct>
            <cmcn_yr>2002</cmcn_yr>
        </item>
    </list>
</response>

오픈 API 서비스

물환경측정망

수질 및 수생태계 환경기준

녹조(조류) 정보

수질오염총량 관리제도

비점오염원

광역·지방상수도 시설

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

검색필터

검색 대상

결과 내 재검색