비점오염물질측정망

사용 설명

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

요청 URL

https://mulmoa.go.kr/api/v1/npsNetwork/nonpointPollutionSites

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
basin	선택	권역	1 : 한강 2 : 낙동강 3 : 금강 4 : 영산강
output	선택	출력 포맷	xml, json(기본값)

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

샘플 URL

https://mulmoa.go.kr/api/v1/npsNetwork/nonpointPollutionSites?apikey=APIKEY

요청결과 출력

결과 변수
변수명	설명	비고
NPLTS_MNTNW_CD	비점오염물질측정망코드
MNTNW_NM	측정망명
daddr	상세주소

오류코드 설명

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

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>39</count>
    <data/>
    <list>
        <item>
            <nplts_mntnw_cd>3301N30</nplts_mntnw_cd>
            <mntnw_nm>N전주천2</mntnw_nm>
            <daddr>전라북도 전주시 덕진구 고랑동 1150-4 (미산교 하류보)</daddr>
        </item>
        <item>
            <nplts_mntnw_cd>1001N40</nplts_mntnw_cd>
            <mntnw_nm>N반천</mntnw_nm>
            <daddr>강원도 정선군 임계면 반천리 628-1 (반천1교)</daddr>
        </item>
        <item>
            <nplts_mntnw_cd>3301N20</nplts_mntnw_cd>
            <mntnw_nm>N삼천</mntnw_nm>
            <daddr>전라북도 전주시 완산구 서신동 972 (서곡교)</daddr>
        </item>
        <item>
            <nplts_mntnw_cd>1001N30</nplts_mntnw_cd>
            <mntnw_nm>N혈천</mntnw_nm>
            <daddr>강원도 정선군 임계면 낙천리 328-7 (혈천교하류)</daddr>
        </item>
        <item>
            <nplts_mntnw_cd>1012N10</nplts_mntnw_cd>
            <mntnw_nm>N자운</mntnw_nm>
            <daddr>강원도 홍천군 내면 광원리 1863 (자운교)</daddr>
        </item>
        <item>
            <nplts_mntnw_cd>1101N20</nplts_mntnw_cd>
            <mntnw_nm>N황계</mntnw_nm>
            <daddr>경기도 화성시 황계동 193-2(황계교)</daddr>
        </item>
        <item>
            <nplts_mntnw_cd>1001N99</nplts_mntnw_cd>
            <mntnw_nm>N삼옥</mntnw_nm>
            <daddr>강원도 영월군 영월읍 삼옥리 539-1 (삼옥교)</daddr>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/npsNetwork/nonpointPollutionData

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
pDataGubun	필수	구분	55 : 자동 56 : 수동
stationCodes	필수	측정망코드	예) 1011N10
pSDay	선택	조회시작일	YYYYMMDD
pEDay	선택	조회종료일	YYYYMMDD
output	선택	출력 포맷	xml, json(기본값)

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

샘플 URL

https://mulmoa.go.kr/api/v1/npsNetwork/nonpointPollutionData?apikey=APIKEY&pDataGubun=55&stationCodes=1011N10

요청결과 출력

결과 변수
변수명	설명	비고
MNTNW_NM	측정소명
EXMN_CYCL	수분석 업로드 지수	(수동)
DATA_SE_NM	측정 단위 구분	(수동)
MSRMT_DT	측정일
TM	측정시간
ITEM_1063	수온	(자동)
ITEM_1046	수소이온농도	(자동)
ITEM_1053	전기전도도	(자동)
ITEM_1057	용존산소	(자동)
ITEM_1502	탁도	(자동)
ITEM_1058	총질소
ITEM_1059	총인
ITEM_1074	총유기탄소
ITEM_1504	강우량
ITEM_1061	수위
ITEM_1056	부유물질	(수동)
ITEM_1055	생물학적산소요구량	(수동)
RMRK_CN	비고	(수동)

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/npsNetwork/nonpointPollutionData';

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>26012</count>
    <data/>
    <list>
        <item>
            <mntnw_nm>N용산</mntnw_nm>
            <msrmt_dt>2025-03-04</msrmt_dt>
            <tm>21</tm>
            <item_1063>0.00</item_1063>
            <item_1046>0.00</item_1046>
            <item_1053>0.00</item_1053>
            <item_1057>0.00</item_1057>
            <item_1502>0.00</item_1502>
            <item_1058>0.00</item_1058>
            <item_1059>0.00</item_1059>
            <item_1074>0.00</item_1074>
            <item_1504/>
            <item_1061>1.00</item_1061>
        </item>
        <item>
            <mntnw_nm>N용산</mntnw_nm>
            <msrmt_dt>2024-10-12</msrmt_dt>
            <tm>11</tm>
            <item_1063>17.21</item_1063>
            <item_1046>8.45</item_1046>
            <item_1053>0.24</item_1053>
            <item_1057>8.96</item_1057>
            <item_1502>1.96</item_1502>
            <item_1058>4.13</item_1058>
            <item_1059>0.02</item_1059>
            <item_1074>1.51</item_1074>
            <item_1504/>
            <item_1061>0.73</item_1061>
        </item>
        <item>
            <mntnw_nm>N용산</mntnw_nm>
            <msrmt_dt>2026-08-06</msrmt_dt>
            <tm>07</tm>
            <item_1063>26.95</item_1063>
            <item_1046>8.09</item_1046>
            <item_1053>271.00</item_1053>
            <item_1057>5.68</item_1057>
            <item_1502>3.24</item_1502>
            <item_1058>2.90</item_1058>
            <item_1059>0.01</item_1059>
            <item_1074>2.25</item_1074>
            <item_1504/>
            <item_1061>1.17</item_1061>
        </item>
    </list>
</response>

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

내 주변 물정보

데이터 검색

데이터 활용

오픈 API 서비스

물환경측정망

수질 및 수생태계 환경기준

녹조(조류) 정보

수질오염총량 관리제도

비점오염원

참여마당

정보마당

비점오염물질측정망

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

오픈 API 서비스

물환경측정망

수질 및 수생태계 환경기준

녹조(조류) 정보

수질오염총량 관리제도

비점오염원

비점오염물질측정망

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

검색필터

검색 대상

결과 내 재검색