XML JSON

기상청_서리발생 가능성 예측정보 조회서비스

QuickAISummary

관심목록에 추가

오픈 API 정보

데이터 오류·개선 의견이 있으신가요?

기본 정보

OpenAPI 명
기상청_서리발생 가능성 예측정보 조회서비스
분류체계
과학기술 - 과학기술연구
제공기관
기상청
관리부서명
국가기후데이터센터
관리부서 전화번호

상세 및 제공정보

설명
동네예보자료를 활용해 서리 발생 가능성 예측 정보를 조회하는 서비스 UM수치모델 지역, UM수치모델 국지 자료와 과거 기사란 검색(관측정보) 자료를 이용, Random Forcast 방법을 이용하여 통계적 관계식을 만들었으며, 해당 관계식을 적용하여 서리발생 확률을 예측, 해당 정보를 제공합니다. (참고) 서리(Frost)란 밤사이 복사냉각으로 인해 지표면 근처의 기온이 0 ℃ 이하로 떨어지며 수증기가 얼어붙는 현상입니다. 작물의 잎·줄기·꽃·열매에 직접 얼음이 맺혀 손상되기 쉽기 때문에 농업재해로 분류됩니다.
API 유형
REST
데이터 포맷
JSON+XML
공간범위
-
시간범위
-
키워드
서리,농작물,동네예보,복사냉각,서리발생
활용신청 수
253
등록일
2019-12-30
수정일
2025-09-17

이용 조건 및 라이선스 정보

비용부과유무
무료
이용허락범위

공공저작물 : 출처표시 (제 1유형)
심의유형
개발단계 : 자동승인 / 운영단계 : 자동승인
신청 가능 트래픽
개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능

참고문서

기상청28_서리발생_가능성_예측정보_조회서비스_오픈API활용가이드.docx

표준 메타데이터

※ 데이터 연계 및 검색을 위한 표준 메타데이터입니다.

Schema.org DCAT

활용 정보

API 서비스

조회조건(생성일자, 생성시간, 선행일)으로 서리 발생 예측 데이터(예측일자, 서리 발생 가능성 등)를 조회하는 기능

API 기본 정보

활용승인 절차
개발단계 : 자동승인 / 운영단계 : 자동승인
신청 가능 트래픽
개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
요청주소
https://apis.data.go.kr/1360000/FrstFcstInfoService/getFrstOcurFcst
서비스 URL
https://apis.data.go.kr/1360000/FrstFcstInfoService

요청변수(Request Parameter)

해당 오픈API의 요청변수(Request Parameter) 항목에 대한 표로, 국문항목명, 영문 항목명, 항목크기, 항목구분, 샘플데이터, 항목 설명순으로 나열됩니다.
항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
서비스키	ServiceKey	4	필수	-	공공데이터포털에서 받은 인증키
페이지 번호	pageNo	4	필수	1	페이지번호
한 페이지 결과 수	numOfRows	4	필수	10	한 페이지 결과 수
응답자료형식	dataType	4	옵션	XML	요청자료형식(XML/JSON)
생성일자	BASE_DATE	8	옵션	20170121	‘17년01월21일 생성
생성시간	BASE_TIME	4	옵션	0500	05시 생성
위도	LAT	4	필수	36.5	36.5
경도	LON	4	필수	128.0	128.0

출력결과(Response Element)

해당 오픈API의 출력결과(Response Element) 항목에 대한 표로, 국문항목명, 영문 항목명, 항목크기, 항목구분, 샘플데이터, 항목 설명순으로 나열됩니다.
항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
결과코드	resultCode	2	필수	00	결과코드
결과메시지	resultMsg	50	필수	OK	결과메시지
한 페이지 결과 수	numOfRows	4	필수	10	한 페이지 결과 수
페이지 번호	pageNo	4	필수	1	페이지번호
전체 결과 수	totalCount	4	필수	3	전체 결과 수
데이터 타입	dataType	4	필수	XML	응답자료형식 (XML/JSON)
생성일자	BASE_DATE	8	필수	20170121	생성일자
생성시간	BASE_TIME	4	필수	0500	생성시간
예측일자	FCST_DATE	8	필수	20170122	예측일자
예측시간	FCST_TIME	4	필수	0000	예측시간
선행일	DAY	4	필수	1	선행일
서리 발생 가능성(%)	VALUE	4	필수	2	서리 발생 가능성(%)

오픈 API에 대한 에러코드를 에러메시지, 에러코드, 설명 순으로 안내하는 표입니다.
에러메시지	에러코드	설명
APPLICATION_ERROR	01	GW 내부 처리 중 예기치 않은 오류가 발생했습니다. 잠시 후 다시 호출하고, 문제가 반복되면 활용지원센터로 문의해 주세요.
HTTP_ERROR	04	허용되지 않은 HTTP 요청이거나 기관 API 응답 처리에 실패했습니다. 요청 방식과 호출 URL을 확인해 주세요.
SERVICETIMEOUT_ERROR	05	기관 API 또는 GW 연계 서비스와의 연결에 실패했거나 응답 대기시간을 초과했습니다. 잠시 후 다시 호출해 주세요.
INVALID_REQUEST_PARAMETER_ERROR	10	요청 파라미터의 값이나 형식이 올바르지 않습니다. API 명세에서 파라미터 이름, 형식 및 허용값을 확인해 주세요.
NO_OPENAPI_SERVICE_ERROR	12	요청한 오픈API 서비스가 존재하지 않거나 폐기되었습니다. 호출 URL에 오타가 없는지 확인해 주세요.
SERVICE_KEY_IS_NULL	20	요청에 API 인증키가 포함되지 않았습니다. 공공데이터포털에서 발급받은 인증키를 요청 파라미터에 포함해 주세요.
PERMISSION_DENIED	20	GW 접근 권한 검사에서 요청이 거부되었습니다. 해당 API의 활용신청 및 접근 권한을 확인해 주세요.
LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS_ERROR	22	API 서비스의 일일 호출 허용량을 초과했습니다. 호출량이 초기화된 이후 다시 이용하거나 트래픽 증설을 신청해 주세요.
LIMITED_NUMBER_OF_SERVICE_REQUESTS_PER_SECOND_EXCEEDS_ERROR	23	짧은 시간에 많은 요청이 발생하여 초당 호출 허용량을 초과했습니다. 잠시 후 다시 호출해 주세요.
BLACKLIST_IP_ACCESS_ERROR	29	차단된 IP에서 호출한 요청입니다. 호출 서버의 IP를 확인하고, 차단 해제가 필요한 경우 활용지원센터로 문의해 주세요.

인증 에러

오픈 API에 대한 인증 에러코드를 에러메시지, 에러코드, 설명 순으로 안내하는 표입니다.
에러메시지	에러코드	설명
SERVICE_ACCESS_DENIED_ERROR	20	해당 API 서비스에 대한 이용 권한이 확인되지 않습니다. 활용신청 여부와 승인 또는 일시중지 상태를 확인해 주세요.
SERVICE_KEY_IS_NOT_REGISTERED_ERROR	30	등록되지 않은 API 인증키입니다. 인증키가 정확한지와 해당 서비스의 활용신청이 정상적으로 완료되었는지 확인해 주세요.
DEADLINE_HAS_EXPIRED_ERROR	31	API 인증키의 사용 기한이 만료되었습니다. 공공데이터포털에서 이용 기간을 확인하거나 갱신해 주세요.