이 누리집은 대한민국 공식 전자정부 누리집입니다.

자원조사

정보

사용 설명

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

요청 URL

http://www.mulmoa.go.kr/openapi/api/v1/landDevelopment/landCategory

요청 변수

요청 변수
변수명 필수 여부 설명 사용 예
apikey 필수 인증키 

                                                    		
                                                

                                            
                                                

                                                    year
                                                    필수
                                                    년도
                                                    
                                                        
yyyy

                                                    		
                                                

                                            
                                                

                                                    admcd
                                                    선택
                                                    행정구역 코드
                                                    
                                                        
11 : 서울특별시
26 : 부산광역시
27 : 대구광역시
28 : 인천광역시
29 : 광주광역시
30 : 대전광역시
31 : 울산광역시
36 : 세종특별자치시
41 : 경기도
42 : 강원도
43 : 충청북도
44 : 충청남도
45 : 전라북도
46 : 전라남도
47 : 경상북도
48 : 경상남도
50 : 제주특별자치도

                                                    		
                                                

                                            
                                                

                                                    output
                                                    선택
                                                    출력 포맷
                                                    
                                                        
xml(기본값), json

                                                    		
                                                

                                            
                                            
                                        

                                    

                                

                                

                                    

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

                                

                                
                                
샘플 URL

                                
http://www.mulmoa.go.kr/openapi/api/v1/landDevelopment/landCategory?apikey=APIKEY&year=2010


                                
                                
요청결과 출력

                                

                                    

                                        

                                            결과 변수
                                            
                                            

                                                변수명
                                                설명
                                                비고
                                            

                                            
                                            
                                            
                                                

                                                    total_ar
                                                    총계
                                                    

                                                

                                            
                                                

                                                    spring_ar
                                                    광천지
                                                    

                                                

                                            
                                                

                                                    buld_site_ar
                                                    대지
                                                    

                                                

                                            
                                                

                                                    fact_site_ar
                                                    공장용지
                                                    

                                                

                                            
                                                

                                                    schl_site_ar
                                                    학교용지
                                                    

                                                

                                            
                                                

                                                    road_site_ar
                                                    도로용지
                                                    

                                                

                                            
                                                

                                                    rail_site_ar
                                                    철도용지
                                                    

                                                

                                            
                                                

                                                    embk_ar
                                                    제방
                                                    

                                                

                                            
                                                

                                                    wtr_site_ar
                                                    수도용지
                                                    

                                                

                                            
                                                

                                                    sport_site_ar
                                                    체육용지
                                                    

                                                

                                            
                                                

                                                    amuse_ar
                                                    유원지
                                                    

                                                

                                            
                                                

                                                    rlgn_site_ar
                                                    종교용지
                                                    

                                                

                                            
                                                

                                                    hist_site_ar
                                                    사적지
                                                    

                                                

                                            
                                                

                                                    misc_ar
                                                    잡종지
                                                    

                                                

                                            
                                                

                                                    field_ar
                                                    전
                                                    

                                                

                                            
                                                

                                                    paddy_ar
                                                    답
                                                    

                                                

                                            
                                                

                                                    orchd_ar
                                                    과수원
                                                    

                                                

                                            
                                                

                                                    frst_ar
                                                    임야
                                                    

                                                

                                            
                                                

                                                    ranch_site_ar
                                                    목장용지
                                                    

                                                

                                            
                                                

                                                    park_ar
                                                    공원
                                                    

                                                

                                            
                                                

                                                    cmtry_ar
                                                    묘지
                                                    

                                                

                                            
                                                

                                                    salt_ar
                                                    염전
                                                    

                                                

                                            
                                                

                                                    etc_ar
                                                    기타
                                                    

                                                

                                            
                                                

                                                    river_ar
                                                    하천
                                                    

                                                

                                            
                                                

                                                    ditch_ar
                                                    구거
                                                    

                                                

                                            
                                                

                                                    pond_ar
                                                    유지
                                                    

                                                

                                            
                                            
                                        

                                    

                                

                                
                                
오류코드 설명

                                

                                    

                                        

                                            오류코드 설명
                                            
                                                
                                                
                                                
                                            
                                            
                                            

                                                오류코드
                                                설명
                                            

                                            
                                            
                                            

                                                00
                                                정상 처리
                                            

                                            

                                                10
                                                잘못된 요청 파라미터
                                            

                                            

                                                11
                                                필수 파라미터 누락
                                            

                                            

                                                22
                                                호출 한도 초과
                                            

                                            

                                                30
                                                등록되지 않은 API key
                                            

                                            

                                                31
                                                사용할 수 없는 API key(비활성, 차단, 승인대기)
                                            

                                            

                                                99
                                                시스템(기타) 에러
                                            

                                            
                                        

                                    

                                

                            

                            
                            

                                
샘플 코드

                                

                                    

                                        
                                            Open API를 보다 쉽게 활용할 수 있도록 주요 언어별 샘플 코드(Sample Code)를 제공합니다.

                                            제공된 예제를 참고하여 API 호출 방식, 인증 처리, 요청/응답 구조를 빠르게 이해할 수 있으며,
                                            서비스 환경에 맞춰 자유롭게 수정하여 사용할 수 있습니다.
                                        
                                    

                                

                                

                                    

                                        
                                        

                                            
    
                                                
                                                
                                            

                                        

                                        
                                        
                                        

                                            

                                                

                                                    

                                                        Java
                                                        
                                                    

                                                    

                                                    

                                                

                                            

                                            

                                                

                                                    

                                                        JavaScript
                                                        
                                                    

                                                    

const API_URL = 'http://www.mulmoa.go.kr/openapi/api/v1/landDevelopment/landCategory';

function getObsData() {
    axios.get(API_URL)
        .then(response => {
            const res = response.data;

            // 응답 코드 확인
            if (res.result.code === '00') {
                console.log(`조회 성공 (총 ${res.count}건)`);
                console.log('데이터 목록:', res.list);

                // 여기서 res.list 배열을 활용해 비즈니스 로직 처리
            } else {
                console.error('API 내부 에러:', res.result.msg);
            }
        })
        .catch(error => {
            console.error('API 호출 중 통신 에러 발생:', error);
        });
}
                                                    

                                                

                                            

                                        


                                        
                                    

                                

                            


                            
                            

                                
제공정보 미리보기

                                
                                    {
                                      "result": {
                                        "code": "00",
                                        "msg": "정상적으로 처리되었습니다."
                                      },
                                      "count": 735,
                                      "list": [
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "평창군(월정분교)",
                                          "obscd": "10014010  "
                                        },
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "정선군(정선군2청사)",
                                          "obscd": "10014020  "
                                        },
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "상원사",
                                          "obscd": "10014070  "
                                        },
                                        {
                                          "mngorg": "기후에너지환경부",
                                          "obsnm": "강릉시(대기리)",
                                          "obscd": "10014080  "
                                        },
                                                    .
                                                    .
                                                    .
                                

                            


                        

                    

                

            

            
        


    







			                

			            

			        

			        
	    		

	    
        
        

    

    
    
	


	    
	    

	    
	    

	    
	
	    
	    

	        
	        

	            
 
	                
	                

	                    
검색필터

	                

	                 
	                
	                

	                    
    
	                        
  • 
	                            
    
	                                
	                            
    
	                            
    
		                            
    
			                            
    
		                                    
    
		                                        
		                                        
		                                    
    
		                                    
    
		                                        
		                                        
		                                    
    
		                                    
    
		                                        
		                                        
		                                    
    
		                                    
    
		                                        
		                                        
		                                    
    
		                                    
    
		                                        
		                                        
		                                    
    
			                            
    
		                            
    
		                        
    
	                        
    • 
	                        
  • 
	                            
    
	                                
	                            
    
	                            
    
	                                
    
	                                    
    
	                                        
    
	                                            
    
	                                                
	                                                
	                                            
    
	                                            
    
	                                                
	                                                
	                                            
    
	                                        
    
	                                        
    
	                                    
    
	                                
    
	                            
    
	                        
    •