수질측정망

사용 설명

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

요청 URL

https://mulmoa.go.kr/api/v1/waterQualityNetwork/riverSites

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
type	필수		1 : 하천 2: 호소 3:농업용수 4:산단하천 5:도시관류
basin	선택	대권역	R01 : 한강 R02 : 낙동강 R03 : 금강 R04 : 영산강
output	선택	출력 포맷	xml, json(기본값)

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

샘플 URL

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

요청결과 출력

결과 변수
변수명	설명	비고
larea_cd	대권역명
mdare_cd	중권역명
CD_NM	수질측정망명
wqmn_cd	수질측정망코드
oper_yn	운영여부
reg_yy	설치년도
exmn_inst_cd	조사기관명
lat	경도
lot	위도
addr	위치

오류코드 설명

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

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>716</count>
    <data/>
    <list>
        <item>
            <larea_cd>한강</larea_cd>
            <mdare_cd>충주댐</mdare_cd>
            <cd_nm>가곡</cd_nm>
            <wqmn_cd>1003A20</wqmn_cd>
            <oper_yn>운영중</oper_yn>
            <reg_yy>1980</reg_yy>
            <exmn_inst_cd>원주지방환경청</exmn_inst_cd>
            <lat>37.0385830000</lat>
            <lot>128.4058330000</lot>
            <addr>충청북도 단양군 가곡면 가대리</addr>
        </item>
        <item>
            <larea_cd>한강</larea_cd>
            <mdare_cd>삼척오십천</mdare_cd>
            <cd_nm>가곡천</cd_nm>
            <wqmn_cd>1303A50</wqmn_cd>
            <oper_yn>운영중</oper_yn>
            <reg_yy>1992</reg_yy>
            <exmn_inst_cd>원주지방환경청</exmn_inst_cd>
            <lat>37.1642220000</lat>
            <lot>129.3426390000</lot>
            <addr>강원도 삼척시 원덕읍 월천리</addr>
        </item>
        <item>
            <larea_cd>한강</larea_cd>
            <mdare_cd>충주댐</mdare_cd>
            <cd_nm>가대천</cd_nm>
            <wqmn_cd>1003A25</wqmn_cd>
            <oper_yn>운영중</oper_yn>
            <reg_yy>1994</reg_yy>
            <exmn_inst_cd>충청북도 보건환경연구원</exmn_inst_cd>
            <lat>37.0450580000</lat>
            <lot>128.4011530000</lot>
            <addr>충청북도 단양군 가곡면 가대리</addr>
        </item>
        <item>
            <larea_cd>금강</larea_cd>
            <mdare_cd>용담댐</mdare_cd>
            <cd_nm>가막</cd_nm>
            <wqmn_cd>3001A10</wqmn_cd>
            <oper_yn>운영중</oper_yn>
            <reg_yy>2004</reg_yy>
            <exmn_inst_cd>금강물환경센터</exmn_inst_cd>
            <lat>35.8021110000</lat>
            <lot>127.5178060000</lot>
            <addr>전라북도 진안군 진안읍 가막리</addr>
        </item>
        <item>
            <larea_cd>낙동강</larea_cd>
            <mdare_cd>회천</mdare_cd>
            <cd_nm>가야천</cd_nm>
            <wqmn_cd>2013A20</wqmn_cd>
            <oper_yn>운영중</oper_yn>
            <reg_yy>1992</reg_yy>
            <exmn_inst_cd>경상남도 보건환경연구원</exmn_inst_cd>
            <lat>35.7889000000</lat>
            <lot>128.1014250000</lot>
            <addr>경상남도 합천군 가야면 치인리</addr>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/waterQualityNetwork/riverData

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
type	필수		1 : 하천 2: 호소 3:농업용수 4:산단하천 5:도시관류
stationCodes	필수	지점코드	3008A40
pDateGu	필수	구분	1 : 일자료 2 : 월자료 3 : 년자료
pSDate	선택	시작연월	201202
pEDate	선택	종료연월	201205
output	선택	출력 포맷	xml, json(기본값)

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

샘플 URL

https://mulmoa.go.kr/api/v1/waterQualityNetwork/riverData?apikey=APIKEY&stationCodes=1003A20&pDateGu=2

요청결과 출력

결과 변수
변수명	설명	비고
RNUM	일련번호
wqmn_nm	수질측정망명
insp_ymd	검사일자
exmn_tseq_val	조사회차
spwt_ymd	채수일자
spwt_tm	채수시각
IEM_1058	수위	(m)
IEM_1060	수온	(℃)
IEM_1054	용존산소(DO)	(㎎/L)
IEM_1052	생물학적산소요구량(BOD)	(㎎/L)
IEM_1049	화학적산소요구량(COD)	(㎎/L)
IEM_1053	부유물질(SS)	(㎎/L)
IEM_1055	총질소(T-N)	(㎎/L)
IEM_1056	총인(T-P)	(㎎/L)
IEM_1073	총유기탄소(TOC)	(㎎/L)
IEM_1039	수소이온농도	(pH)
IEM_1016	페놀(phenol)	(㎎/L)
IEM_1050	전기전도도(EC)	(μS/㎝)
IEM_1002	총대장균군수	(총대장균군수/100ml)
IEM_1014	카드뮴(Cd)	(㎎/L)
IEM_1010	시안(CN)	(㎎/L)
IEM_1005	납(Pb)	(㎎/L)
IEM_1011	6가크롬(Cr6+)	(㎎/L)
IEM_1007	비소(As)	(㎎/L)
IEM_1009	수은(Hg)	(㎎/L)
IEM_1061	구리(Cu)	(㎎/L)
IEM_1040	아연(Zn)	(㎎/L)
IEM_1057	크롬(Cr)	(㎎/L)
IEM_1095	니켈(Ni)	(㎎/L)
IEM_1096	바륨(Ba)	(㎎/L)
IEM_1097	셀레늄(Se)	(㎎/L)
IEM_1066	용존총질소(DTN)	(㎎/L)
IEM_1012	암모니아성질소(NH₃-N)	(㎎/L)
IEM_1013	질산성질소(NO₃-N)	(㎎/L)
IEM_1067	용존총인(DTP)	(㎎/L)
IEM_1065	인산염(PO₄-P)	(㎎/L)
IEM_1063	클로로필-a(Chlorophyll-a)	(㎎/㎥)
IEM_1094	헥사클로로벤젠(HCB)	(㎍/L)
IEM_1004	분원성대장균군수
IEM_1006	불소(F)	(㎎/L)
IEM_1037	색도	(㎎/L)
IEM_1064	N헥산(N-H)	(㎎/L)
IEM_1044	용해성망간	(㎎/L)
IEM_1043	용해성철(Fe)	(㎎/L)
IEM_1038	음이온계면활성제(ABS)	(㎎/L)
IEM_1023	트리클로로에틸렌(TCE)	(㎎/L)
IEM_1022	테트라클로로에틸렌(PCE)	(㎎/L)
IEM_1030	사염화탄소
IEM_1071	1,2-다이클로로에탄	(㎎/L)
IEM_1024	다이클로로메탄	(㎎/L)
IEM_1025	벤젠	(㎎/L)
IEM_1051	폴리염화바이페닐(PCB)	(㎎/L)
IEM_1048	유기인	(㎎/L)
IEM_1083	안티몬(ANTIMON)	(㎎/L)
IEM_1072	클로로포름	(㎎/L)
IEM_1082	디에틸헥실프탈레이트(DEHP)	(㎎/L)
IEM_1086	1.4-다이옥세인	(㎎/L)
IEM_1062	투명도	(m)
IEM_1059	유량	(㎥/s)
IEM_1093	포름알데히드	(㎎/L)
IEM_1041	염소이온(cl-)	(㎎/L)

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/waterQualityNetwork/riverData';

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>74</count>
    <data/>
    <list>
        <item>
            <rnum>1</rnum>
            <wqmn_nm>가곡</wqmn_nm>
            <insp_ymd>1994-01</insp_ymd>
            <iem_1058/>
            <iem_1060>4.0</iem_1060>
            <iem_1054>12.6</iem_1054>
            <iem_1052>0.7</iem_1052>
            <iem_1049>1.2</iem_1049>
            <iem_1053>2.0</iem_1053>
            <iem_1055>1.700</iem_1055>
            <iem_1056>0.030</iem_1056>
            <iem_1073/>
            <iem_1039>7.8</iem_1039>
            <iem_1016>0.000</iem_1016>
            <iem_1050>160</iem_1050>
            <iem_1002>40</iem_1002>
            <iem_1014/>
            <iem_1010/>
            <iem_1005/>
            <iem_1011/>
            <iem_1007/>
            <iem_1009/>
            <iem_1061/>
            <iem_1040/>
            <iem_1057/>
            <iem_1095/>
            <iem_1096/>
            <iem_1097/>
            <iem_1066/>
            <iem_1012/>
            <iem_1013/>
            <iem_1067/>
            <iem_1065/>
            <iem_1063/>
            <iem_1094/>
            <iem_1004/>
            <iem_1006/>
            <iem_1037/>
            <iem_1064/>
            <iem_1044/>
            <iem_1043/>
            <iem_1038/>
            <iem_1023/>
            <iem_1022/>
            <iem_1030/>
            <iem_1071/>
            <iem_1024/>
            <iem_1025/>
            <iem_1051/>
            <iem_1048/>
            <iem_1083/>
            <iem_1072/>
            <iem_1082/>
            <iem_1086/>
            <iem_1062/>
            <iem_1059/>
            <iem_1093/>
            <iem_1041/>
        </item>
        <item>
            <rnum>2</rnum>
            <wqmn_nm>가곡</wqmn_nm>
            <insp_ymd>1994-02</insp_ymd>
            <iem_1058/>
            <iem_1060>5.0</iem_1060>
            <iem_1054>13.5</iem_1054>
            <iem_1052>0.6</iem_1052>
            <iem_1049>2.1</iem_1049>
            <iem_1053>0.7</iem_1053>
            <iem_1055>1.955</iem_1055>
            <iem_1056>0.031</iem_1056>
            <iem_1073/>
            <iem_1039>8.1</iem_1039>
            <iem_1016>0.000</iem_1016>
            <iem_1050>180</iem_1050>
            <iem_1002>20</iem_1002>
            <iem_1014/>
            <iem_1010/>
            <iem_1005/>
            <iem_1011/>
            <iem_1007/>
            <iem_1009/>
            <iem_1061/>
            <iem_1040/>
            <iem_1057/>
            <iem_1095/>
            <iem_1096/>
            <iem_1097/>
            <iem_1066/>
            <iem_1012/>
            <iem_1013/>
            <iem_1067/>
            <iem_1065/>
            <iem_1063/>
            <iem_1094/>
            <iem_1004/>
            <iem_1006/>
            <iem_1037/>
            <iem_1064/>
            <iem_1044/>
            <iem_1043/>
            <iem_1038/>
            <iem_1023/>
            <iem_1022/>
            <iem_1030/>
            <iem_1071/>
            <iem_1024/>
            <iem_1025/>
            <iem_1051/>
            <iem_1048/>
            <iem_1083/>
            <iem_1072/>
            <iem_1082/>
            <iem_1086/>
            <iem_1062/>
            <iem_1059/>
            <iem_1093/>
            <iem_1041/>
        </item>
    </list>
</response>

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

내 주변 물정보

데이터 검색

데이터 활용

오픈 API 서비스

물환경측정망

수질 및 수생태계 환경기준

녹조(조류) 정보

수질오염총량 관리제도

비점오염원

참여마당

정보마당

수질측정망

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

오픈 API 서비스

물환경측정망

수질 및 수생태계 환경기준

녹조(조류) 정보

수질오염총량 관리제도

비점오염원

수질측정망

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

검색필터

검색 대상

결과 내 재검색