Open API 소개

산사태정보시스템 Open API란, 산림청에서 분석한 산사태 예측정보와 각 지방자치단체에서 발령한 산사태 예보발령정보를 개인 또는 기관에서 Open API를 활용하여 자유롭게 이용할 수 있도록 제공합니다.

Open API란?

플랫폼으로서의 "웹" 이라는 특징을 기술적으로 구현한 대표적인 Web 2.0 기술입니다. 하나의 웹 사이트에서 자신이 가진 기능을 이용할 수 있도록 공개한 프로그래밍 인터페이스를 Open API라고 합니다.

Open API 서비스 신청방법

사용신청메뉴클릭 - 사용신청작성 - 담당자 검토/승인 - 신청시 작성하신 이메일로 인증키 발송

검토과정에서 사용신청이 반려되는 경우에는 반려사유를 이메일로 발송해드립니다.

  • 인증키란?
    산사태정보시스템의 Open API 서비스를 이용하기 위해서는 인증키가 필요합니다. 인증키가 올바르지 않은 경우에는 서비스 이용에 제한됩니다. 인증키가 유효하지 않거나 분실하여 재발급을 원하시는 경우에는 담당자에게 문의하시기 바랍니다.
OpenAPI 공통요청변수(Common Request Parameter)
OpenAPI 공통요청변수(Common Request Parameter)
No. 요청변수 설명
1 apikey String 발급받은 사용자 인증키
2 pageno Integer : 기본값 1, 최소 1 검색 결과 페이지 번호
3 firstRow Integer : 기본값 1, 최소 1 검색 결과 페이지 시작 번호
4 lastRow Integer : 기본값 10, 최소 10 검색 결과 페이지 끝 번호
요청 주소 (Request URL)
요청 주소 (Request URL)
도메인 http://sansatai.forest.go.kr/lsapi
확장자 .xml(XML 결과값), .json(JSON 결과값), .rss(RSS 결과값)
상세 요청 주소 (Request URL)
상세 요청 주소 (Request URL)
No. 주소 설명
1 /openapi/rainIssueList 산사태예보발령
2 /openapi/rainForecast/{행정구역 별} 산사태예측정보
행정구역별 : districtList-시군구+읍면동 리스트, sggList-시군구 리스트, umdList-읍면동 리스트
산사태 예보발령 출력 결과 (Response Elements)
산사태 예보발령 출력 결과 (Response Elements)
No. 출력 변수 설명
1 issueId String 산사태예보발령 고유번호
2 districtNm String 산사태예보발령 행정구역명
3 issueType String 산사태예보발령종류
4 issueState String 산사태예보발령상태
5 issueDt String 산사태예보발령일
6 clearDt String 산사태예보발령 해제일
산사태 예측정보 출력 결과 (Response Elements)
산사태 예측정보 출력 결과 (Response Elements)
No. 출력 변수 설명
1 castType String 산사태발생 예측종류
2 districtNm String 행정구역명
3 districtDo String 행정구역명(시도)
4 districtSgg String 행정구역명(시군구)
5 siguCode String 행정구역(코드)
6 castDate String 산사태발생 예측시간
산사태 예측정보 출력 결과 (Response Elements)
산사태 예측정보 출력 결과 (Response Elements)
No. 코드 설명
1 101: fail data 시스템 문제로 데이터 가져오지 못했습니다.
2 201: wrong apiKey 잘못된 인증키입니다.
3 301: wrong parameter 잘못된 parameter가 있습니다.
4 401: wrong limit 일일 검색 횟수제한을 초과하였습니다.
5 501: shut out 검색이 차단 되었습니다.
6 601: wrong apiKey not approved 미승인 인증키 입니다.

서비스 사용신청

*는 필수 입력사항입니다.
API 서비스 사용신청 테이블입니다.
*구분
(사업자등록번호 또는 법인등록번호)
- - - -
@

(※ 신청이 정상적이지 않을 경우, 메일(je231498@korea.kr) 로 신청 바랍니다.)

서비스 신청조회

*는 필수 입력사항입니다.
API 서비스 사용조회
@
API 서비스 사용신청 테이블입니다.
인증키 승인여부
*
(사업자등록번호 또는 법인등록번호)
- - - -

(※ 신청이 정상적이지 않을 경우, 메일(je231498@korea.kr) 로 신청 바랍니다.)