생물측정망

사용 설명

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

요청 URL

https://mulmoa.go.kr/api/v1/bioNetwork/bioMeasureSites

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
pDataGubun	필수	구분	76 : 하천 314 : 하구
basin	선택	대권역	R01 : 한강 R02 : 낙동강 R03 : 금강 R04 : 영산강
output	선택	출력 포맷	xml, json(기본값)

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

샘플 URL

https://mulmoa.go.kr/api/v1/bioNetwork/bioMeasureSites?apikey=APIKEY&pDataGubun=76

요청결과 출력

결과 변수
변수명	설명	비고
RNUM	일련번호
CL_CD	대권역
DTL_WTST_NM	수계명
MDARE_CD	중권역
AEM_RVR_NM	지점명
AEM_CD	지점코드
DADDR	주소
INSTL_YY	설치년도
inst	조사기관명

오류코드 설명

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

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>3049</count>
    <data/>
    <list>
        <item>
            <rnum>1</rnum>
            <cl_cd>한강</cl_cd>
            <dtl_wtst_nm>남한강</dtl_wtst_nm>
            <mdare_cd>충주댐</mdare_cd>
            <aem_rvr_nm>덕천</aem_rvr_nm>
            <aem_cd>1003G038</aem_cd>
            <daddr>충청북도 단양군 가곡면 덕천리(덕천교)</daddr>
            <instl_yy>2008</instl_yy>
            <inst_cd>한강통합물환경센터</inst_cd>
        </item>
        <item>
            <rnum>2</rnum>
            <cl_cd>한강</cl_cd>
            <dtl_wtst_nm>남한강</dtl_wtst_nm>
            <mdare_cd>충주댐</mdare_cd>
            <aem_rvr_nm>매포천-1</aem_rvr_nm>
            <aem_cd>1003G040</aem_cd>
            <daddr>충청북도 단양군 매포읍 안동리(무명교)</daddr>
            <instl_yy>2017</instl_yy>
            <inst_cd>한강통합물환경센터</inst_cd>
        </item>
        <item>
            <rnum>3</rnum>
            <cl_cd>한강</cl_cd>
            <dtl_wtst_nm>남한강</dtl_wtst_nm>
            <mdare_cd>충주댐</mdare_cd>
            <aem_rvr_nm>덕천1</aem_rvr_nm>
            <aem_cd>1003G042</aem_cd>
            <daddr>충청북도 단양군 단양읍 고수리(고수대교)</daddr>
            <instl_yy>2018</instl_yy>
            <inst_cd>한강통합물환경센터</inst_cd>
        </item>
        <item>
            <rnum>4</rnum>
            <cl_cd>한강</cl_cd>
            <dtl_wtst_nm>남한강</dtl_wtst_nm>
            <mdare_cd>충주댐</mdare_cd>
            <aem_rvr_nm>매포천1</aem_rvr_nm>
            <aem_cd>1003G044</aem_cd>
            <daddr>충청북도 단양군 매포읍 하괴리(하괴교)</daddr>
            <instl_yy>2008</instl_yy>
            <inst_cd>한강통합물환경센터</inst_cd>
        </item>
        <item>
            <rnum>5</rnum>
            <cl_cd>한강</cl_cd>
            <dtl_wtst_nm>남한강</dtl_wtst_nm>
            <mdare_cd>충주댐</mdare_cd>
            <aem_rvr_nm>솔티천</aem_rvr_nm>
            <aem_cd>1003G046</aem_cd>
            <daddr>충청북도 단양군 단양읍 기촌리(기촌교)</daddr>
            <instl_yy>2017</instl_yy>
            <inst_cd>한강통합물환경센터</inst_cd>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/bioNetwork/bioHlthGradeData

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
stationCodes	필수	지점코드	예) 2004G004
pDataSubGubun	필수	조사분야	- 하천 172(부착돌말류) 173(저서성) 174(어류) 175(서식 및 수변환경) 176(수변식생) - 하구 177(부착돌말류) 178(저서성대형무척추동물) 179(어류) 180(수변식생)
pSDate	필수	조회시작일	예) 20170101
pEDate	필수	조회종료일	예) 20201231
output	선택	출력 포맷	xml, json(기본값)

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

샘플 URL

https://mulmoa.go.kr/api/v1/bioNetwork/bioHlthGradeData?apikey=APIKEY&stationCodes=2004G004&pDataSubGubun=172&pSDate=20170101&pEDate=20201231

요청결과 출력

결과 변수
변수명	설명	비고
RNUM	일련번호
YY	조사년도
EXMN_TSEQ_VAL	조사회차
CL_NM	대권역
CD_NM	중권역
AEM_RVR_NM	조사지점
HLTHY_GRD_CD	건강성평가등급

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/bioNetwork/bioHlthGradeData';

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>3</count>
    <data/>
    <list>
        <item>
            <rnum>1</rnum>
            <yy>2017</yy>
            <exmn_tseq_val>1</exmn_tseq_val>
            <cl_nm/>
            <cd_nm>내성천</cd_nm>
            <aem_rvr_nm>가계천1</aem_rvr_nm>
            <hlthy_grd_cd>A</hlthy_grd_cd>
        </item>
        <item>
            <rnum>2</rnum>
            <yy>2017</yy>
            <exmn_tseq_val>2</exmn_tseq_val>
            <cl_nm/>
            <cd_nm>내성천</cd_nm>
            <aem_rvr_nm>가계천1</aem_rvr_nm>
            <hlthy_grd_cd>A</hlthy_grd_cd>
        </item>
        <item>
            <rnum>3</rnum>
            <yy>2020</yy>
            <exmn_tseq_val>1</exmn_tseq_val>
            <cl_nm/>
            <cd_nm>내성천</cd_nm>
            <aem_rvr_nm>가계천1</aem_rvr_nm>
            <hlthy_grd_cd>A</hlthy_grd_cd>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/bioNetwork/bioSpcOcrData

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
stationCodes	필수	지점코드	예) 2004G004
pDataSubGubun	필수	조사분야	- 하천 172(부착돌말류) 173(저서성) 174(어류) 175(서식 및 수변환경) 176(수변식생) - 하구 177(부착돌말류) 178(저서성대형무척추동물) 179(어류) 180(수변식생)
pSDate	필수	조회시작일	예) 20170101
pEDate	필수	조회종료일	예) 20201231
output	선택	출력 포맷	xml, json(기본값)

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

샘플 URL

https://mulmoa.go.kr/api/v1/bioNetwork/bioSpcOcrData?apikey=APIKEY&stationCodes=2004G004&pDataSubGubun=172&pSDate=20170101&pEDate=20201231

요청결과 출력

결과 변수
변수명	설명	비고
RNUM	일련번호
YY	조사년도
EXMN_TSEQ_VAL	조사회차
AEM_RVR_NM	조사지점
STNM	학명
KRNM	국명
BCLL_DNST_VAL	개체밀도

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/bioNetwork/bioSpcOcrData';

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>72</count>
    <data/>
    <list>
        <item>
            <rnum>1</rnum>
            <yy>2017</yy>
            <exmn_tseq_val>1</exmn_tseq_val>
            <aem_rvr_nm>가계천1</aem_rvr_nm>
            <stnm>Fragilaria (other)</stnm>
            <krnm>김발돌말</krnm>
            <bcll_dnst_val>58</bcll_dnst_val>
        </item>
        <item>
            <rnum>2</rnum>
            <yy>2017</yy>
            <exmn_tseq_val>1</exmn_tseq_val>
            <aem_rvr_nm>가계천1</aem_rvr_nm>
            <stnm>Fragilaria pinnata var. lancettula</stnm>
            <krnm>김발돌말</krnm>
            <bcll_dnst_val>58</bcll_dnst_val>
        </item>
        <item>
            <rnum>3</rnum>
            <yy>2017</yy>
            <exmn_tseq_val>1</exmn_tseq_val>
            <aem_rvr_nm>가계천1</aem_rvr_nm>
            <stnm>Tabellaria flocculosa</stnm>
            <krnm>볼록뼈돌말</krnm>
            <bcll_dnst_val>58</bcll_dnst_val>
        </item>
        <item>
            <rnum>4</rnum>
            <yy>2020</yy>
            <exmn_tseq_val>1</exmn_tseq_val>
            <aem_rvr_nm>가계천1</aem_rvr_nm>
            <stnm>Melosira varians</stnm>
            <krnm>원통돌말</krnm>
            <bcll_dnst_val>97</bcll_dnst_val>
        </item>
        <item>
            <rnum>5</rnum>
            <yy>2017</yy>
            <exmn_tseq_val>2</exmn_tseq_val>
            <aem_rvr_nm>가계천1</aem_rvr_nm>
            <stnm>Rhoicosphenia abbreviata</stnm>
            <krnm>가지돌말</krnm>
            <bcll_dnst_val>8,060</bcll_dnst_val>
        </item>
    </list>
</response>

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

내 주변 물정보

데이터 검색

데이터 활용

오픈 API 서비스

물환경측정망

수질 및 수생태계 환경기준

녹조(조류) 정보

수질오염총량 관리제도

비점오염원

참여마당

정보마당

생물측정망

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

오픈 API 서비스

물환경측정망

수질 및 수생태계 환경기준

녹조(조류) 정보

수질오염총량 관리제도

비점오염원

생물측정망

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

검색필터

검색 대상

결과 내 재검색