유역특성

사용 설명

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

요청 URL

https://mulmoa.go.kr/api/v1/basinCharacteristics/geology

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
type	필수	조건 선택	1 : 경사(경사누가면적비) 2 : 경사(경사누가면적) 3 : 경사(경사범위) 4 : 표고(표고누가면적비) 5 : 표고(표고누가면적) 6 : 표고(표고범위) 7 : 향
bsncd	필수	권역 선택	1 : 한강 2 : 낙동강 3 : 금강 4 : 섬진강 5 : 영산강 6 : 제주도
output	선택	출력 포맷	xml, json(기본값)

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

샘플 URL

https://mulmoa.go.kr/api/v1/basinCharacteristics/geology?apikey=APIKEY&bsncd=1&type=1&bsntype=1

요청결과 출력

결과 변수
변수명	설명	비고
bsncd	유역코드
bsnnm	유역명
bsn_area	유역면적
val1	측정값	경사누가면적비 : 100% 이하 경사누가면적 : 100%이하 경사범위 : 100% 이상 표고누가면적비 : 1200m 이하 표고누가면적 : 1200m 이하 표고범위 : 1200m 이상 향 : 평지
val2	측정값	경사누가면적비 : 80% 이하 경사누가면적 : 80% 이하 경사범위 : 80-100% 표고누가면적비 : 1000m 이하 표고누가면적 : 1000m 이하 표고범위 : 1000-1200 향 : 북
val3	측정값	경사누가면적비 : 60% 이하 경사누가면적 : 60% 이하 경사범위 : 60-80% 표고누가면적비 : 800m 이하 표고누가면적 : 800m 이하 표고범위 : 800-1000 향 : 북동
val4	측정값	경사누가면적비 : 40% 이하 경사누가면적 : 40% 이하 경사범위 :40-60% 표고누가면적비 : 600m 이하 표고누가면적 : 600m 이하 표고범위 : 600-800 향 : 동
val5	측정값	경사누가면적비 : 20% 이하 경사누가면적 : 20% 이하 경사범위 : 20-40% 표고누가면적비 : 400m 이하 표고누가면적 : 400m 이하 표고범위 : 400-600 향 : 남동

오류코드 설명

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

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>290</count>
    <data/>
    <list>
        <item>
            <row_number>1</row_number>
            <wtrsc_std_bsn_cd>100101</wtrsc_std_bsn_cd>
            <std_bsn_nm>광동댐</std_bsn_nm>
            <bsn_area>120.73</bsn_area>
            <pct_le_100>99.3</pct_le_100>
            <pct_le_80>94.81</pct_le_80>
            <pct_le_60>69.84</pct_le_60>
            <pct_le_40>31.69</pct_le_40>
            <pct_le_20>10.44</pct_le_20>
            <pct_le_10>5.57</pct_le_10>
            <pct_le_5>3.53</pct_le_5>
        </item>
        <item>
            <row_number>2</row_number>
            <wtrsc_std_bsn_cd>100102</wtrsc_std_bsn_cd>
            <std_bsn_nm>광동댐하류</std_bsn_nm>
            <bsn_area>171.05</bsn_area>
            <pct_le_100>97.61</pct_le_100>
            <pct_le_80>87.73</pct_le_80>
            <pct_le_60>55.33</pct_le_60>
            <pct_le_40>23.91</pct_le_40>
            <pct_le_20>10.19</pct_le_20>
            <pct_le_10>5.83</pct_le_10>
            <pct_le_5>3.77</pct_le_5>
        </item>
        <item>
            <row_number>3</row_number>
            <wtrsc_std_bsn_cd>100103</wtrsc_std_bsn_cd>
            <std_bsn_nm>임계천</std_bsn_nm>
            <bsn_area>167.85</bsn_area>
            <pct_le_100>98.87</pct_le_100>
            <pct_le_80>93.95</pct_le_80>
            <pct_le_60>75.16</pct_le_60>
            <pct_le_40>43.54</pct_le_40>
            <pct_le_20>16.95</pct_le_20>
            <pct_le_10>7.74</pct_le_10>
            <pct_le_5>4.13</pct_le_5>
        </item>
        <item>
            <row_number>4</row_number>
            <wtrsc_std_bsn_cd>100104</wtrsc_std_bsn_cd>
            <std_bsn_nm>골지천중류</std_bsn_nm>
            <bsn_area>87.56</bsn_area>
            <pct_le_100>95.6</pct_le_100>
            <pct_le_80>83.69</pct_le_80>
            <pct_le_60>56.26</pct_le_60>
            <pct_le_40>29.75</pct_le_40>
            <pct_le_20>12.51</pct_le_20>
            <pct_le_10>6.74</pct_le_10>
            <pct_le_5>4.27</pct_le_5>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/basinCharacteristics/soil

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
type	필수	구분	1 : SCS 2 : 배수 3 : 종류
bsncd	선택	권역 코드	1 : 한강 2 : 낙동강 3 : 금강 4 : 섬진강 5 : 영산강 6 : 제주도
output	선택	출력 포맷

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

샘플 URL

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

요청결과 출력

결과 변수
변수명	설명	비고
bsncd	유역코드
bsnnm	유역명
val1	측정값	SCS : A 배수 : 매우양호 종류 : 종류
val2	측정값	SCS : B 배수 : 양호 종류 : 면적(㎢)
val3	측정값	SCS : C 배수 : 약간 양호
val4	측정값	SCS : D 배수 : 약간 불량
val5	측정값	SCS : 0 배수 : 불량
val6	측정값	배수 : 매우불량
val7	측정값	배수 : 기타

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/basinCharacteristics/soil';

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>21</count>
    <data/>
    <list>
        <item>
            <row_number>1</row_number>
            <bsn_cd>10</bsn_cd>
            <bsn_nm>한강</bsn_nm>
            <val_a>9,372.98</val_a>
            <val_b>5,072.18</val_b>
            <val_c>2,585.97</val_c>
            <val_d>7,152.22</val_d>
            <val_0>985.91</val_0>
        </item>
        <item>
            <row_number>2</row_number>
            <bsn_cd>11</bsn_cd>
            <bsn_nm>안성천</bsn_nm>
            <val_a>475.65</val_a>
            <val_b>221.76</val_b>
            <val_c>226.15</val_c>
            <val_d>660.66</val_d>
            <val_0>54.1</val_0>
        </item>
        <item>
            <row_number>3</row_number>
            <bsn_cd>12</bsn_cd>
            <bsn_nm>한강서해</bsn_nm>
            <val_a>359</val_a>
            <val_b>382.1</val_b>
            <val_c>96.09</val_c>
            <val_d>681.92</val_d>
            <val_0>83.19</val_0>
        </item>
        <item>
            <row_number>4</row_number>
            <bsn_cd>13</bsn_cd>
            <bsn_nm>한강동해</bsn_nm>
            <val_a>876.26</val_a>
            <val_b>900.62</val_b>
            <val_c>237.99</val_c>
            <val_d>1,148.71</val_d>
            <val_0>108.01</val_0>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/runoffAnalysis/runoffCurveNumber

요청 변수

변수명

필수 여부

설명

사용 예

apikey

필수

인증키

bsncd

선택

대권역

10 : 한강
11 : 안성천
12 : 한강서해
13 : 한강동해
20 : 낙동강
21 : 형산강
22 : 태화강
23 : 회야수영
24 : 낙동강동해
25 : 낙동강남해
30 : 금강
31 : 삽교천
32 : 금강서해
33 : 만경동진
40 : 섬진강
41 : 섬진강남해
50 : 영산강
51 : 탐진강
52 : 영산강남해
53 : 영산강서해
60 : 제주도

output

선택

출력 포맷

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

샘플 URL

https://mulmoa.go.kr/api/v1/runoffAnalysis/runoffCurveNumber?apikey=APIKEY

요청결과 출력

결과 변수
변수명	설명	비고
bsn_cd	표준유역코드
bsn_nm	표준유역명
2010	2010 유출곡선지수
2006	2006 유출곡선지수

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/runoffAnalysis/runoffCurveNumber';

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>965</count>
    <data/>
    <list>
        <item>
            <row_number>1</row_number>
            <bsn_cd>1</bsn_cd>
            <bsn_nm/>
            <year_2010>56.6</year_2010>
            <year_2006>60.0</year_2006>
        </item>
        <item>
            <row_number>2</row_number>
            <bsn_cd>10</bsn_cd>
            <bsn_nm>한강</bsn_nm>
            <year_2010>55.5</year_2010>
            <year_2006>59.0</year_2006>
        </item>
        <item>
            <row_number>3</row_number>
            <bsn_cd>1001</bsn_cd>
            <bsn_nm>남한강상류</bsn_nm>
            <year_2010>60.2</year_2010>
            <year_2006>55.0</year_2006>
        </item>
        <item>
            <row_number>4</row_number>
            <bsn_cd>100101</bsn_cd>
            <bsn_nm>광동댐</bsn_nm>
            <year_2010>65.6</year_2010>
            <year_2006>54.0</year_2006>
        </item>
        <item>
            <row_number>5</row_number>
            <bsn_cd>100102</bsn_cd>
            <bsn_nm>광동댐하류</bsn_nm>
            <year_2010>63.6</year_2010>
            <year_2006>61.0</year_2006>
        </item>
        <item>
            <row_number>6</row_number>
            <bsn_cd>100103</bsn_cd>
            <bsn_nm>임계천</bsn_nm>
            <year_2010>51.5</year_2010>
            <year_2006>44.0</year_2006>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/basinResources/forestType

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
type	필수	구분	1 : 임상 2:경급 3:영급 4:수관밀도
bsncd	선택	권역 코드	1 : 한강 2 : 낙동강 3 : 금강 4 : 섬진강 5 : 영산강 6 : 제주도
output	선택	출력 포맷

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

샘플 URL

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

요청결과 출력

결과 변수
변수명	설명	비고
bsncd	표준유역코드
bsnnm	표준유역명
NM	명칭
AREA	면적(㎢)	(임상)
SAP	치수	(경급)
SMALL_DBH	소경목	(경급)
MEDIUM_DBH	중경목	(경급)
LARGE_DBH	대경목	(경급)
AGE_CLASS_1	1영급(㎢)	(영급)
AGE_CLASS_2	2영급(㎢)	(영급)
AGE_CLASS_3	3영급(㎢)	(영급)
AGE_CLASS_4	4영급(㎢)	(영급)
AGE_CLASS_5	5영급(㎢)	(영급)
AGE_CLASS_6	6영급(㎢)	(영급)
AGE_CLASS_7	7영급(㎢)	(영급)
AGE_CLASS_8	8영급(㎢)	(영급)
AGE_CLASS_9	9영급(㎢)	(영급)
DNSTY_1	소밀도(소)(㎢)	(수관밀도)
DNSTY_2	중밀도(중)(㎢)	(수관밀도)
DNSTY_3	소밀도(밀)(㎢)	(수관밀도)
NO_DATA	NoData

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/basinResources/forestType';

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>20400</count>
    <data/>
    <list>
        <item>
            <wtrsc_std_bsn_cd>100101</wtrsc_std_bsn_cd>
            <std_bsn_nm>광동댐</std_bsn_nm>
            <nm>NoData</nm>
            <area>10.93</area>
        </item>
        <item>
            <wtrsc_std_bsn_cd>100101</wtrsc_std_bsn_cd>
            <std_bsn_nm>광동댐</std_bsn_nm>
            <nm>경작지</nm>
            <area>2.48</area>
        </item>
        <item>
            <wtrsc_std_bsn_cd>100101</wtrsc_std_bsn_cd>
            <std_bsn_nm>광동댐</std_bsn_nm>
            <nm>낙엽송림</nm>
            <area>34.7</area>
        </item>
        <item>
            <wtrsc_std_bsn_cd>100101</wtrsc_std_bsn_cd>
            <std_bsn_nm>광동댐</std_bsn_nm>
            <nm>리기다소나무림</nm>
            <area>0.05</area>
        </item>
        <item>
            <wtrsc_std_bsn_cd>100101</wtrsc_std_bsn_cd>
            <std_bsn_nm>광동댐</std_bsn_nm>
            <nm>미립목지</nm>
            <area>0.14</area>
        </item>
    </list>
</response>

사용 설명

요청 URL

https://mulmoa.go.kr/api/v1/landDevelopment/landCover

요청 변수

요청 변수
변수명	필수 여부	설명	사용 예
apikey	필수	인증키
bsncd	선택	권역 코드	1 : 한강 2 : 낙동강 3 : 금강 4 : 섬진강 5 : 영산강 6 : 제주도
output	선택	출력 포맷

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

샘플 URL

https://mulmoa.go.kr/api/v1/landDevelopment/landCover?apikey=APIKEY

요청결과 출력

결과 변수
변수명	설명	비고
yr	년도
wtrsc_bsn_cd	유역코드
wtrsc_bsn_nm	유역명
lcv_se_nm	구분
lcv_area	토지피복면적	(㎢)

오류코드 설명

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

샘플 코드

Java

JavaScript


const API_URL = 'https://mulmoa.go.kr/api/v1/landDevelopment/landCover';

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>54403</count>
    <data/>
    <list>
        <item>
            <row_number>1</row_number>
            <yr>1975</yr>
            <wtrsc_bsn_cd>10</wtrsc_bsn_cd>
            <wtrsc_bsn_nm>한강</wtrsc_bsn_nm>
            <lcv_se_nm>시가화/건조지적</lcv_se_nm>
            <lcv_area>323.210000000</lcv_area>
        </item>
        <item>
            <row_number>2</row_number>
            <yr>1975</yr>
            <wtrsc_bsn_cd>10</wtrsc_bsn_cd>
            <wtrsc_bsn_nm>한강</wtrsc_bsn_nm>
            <lcv_se_nm>논</lcv_se_nm>
            <lcv_area>5173.340000000</lcv_area>
        </item>
        <item>
            <row_number>3</row_number>
            <yr>1975</yr>
            <wtrsc_bsn_cd>10</wtrsc_bsn_cd>
            <wtrsc_bsn_nm>한강</wtrsc_bsn_nm>
            <lcv_se_nm>밭</lcv_se_nm>
            <lcv_area>185.560000000</lcv_area>
        </item>
        <item>
            <row_number>4</row_number>
            <yr>1975</yr>
            <wtrsc_bsn_cd>10</wtrsc_bsn_cd>
            <wtrsc_bsn_nm>한강</wtrsc_bsn_nm>
            <lcv_se_nm>임야</lcv_se_nm>
            <lcv_area>24510.560000000</lcv_area>
        </item>
        <item>
            <row_number>5</row_number>
            <yr>1975</yr>
            <wtrsc_bsn_cd>10</wtrsc_bsn_cd>
            <wtrsc_bsn_nm>한강</wtrsc_bsn_nm>
            <lcv_se_nm>초지</lcv_se_nm>
            <lcv_area>516.680000000</lcv_area>
        </item>
    </list>
</response>

오픈 API 서비스

물환경측정망

수질 및 수생태계 환경기준

녹조(조류) 정보

수질오염총량 관리제도

비점오염원

유역특성

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

사용 설명

요청 URL

요청 변수

샘플 URL

요청결과 출력

오류코드 설명

샘플 코드

제공정보 미리보기

검색필터

검색 대상

결과 내 재검색