예특보

초단기, 단기, 중기예보의 기온, 바람, 강수량 등 데이터를 제공하며, 폭염, 한파, 호우 등 10종의 기상특보(주의보, 경보) 데이터를 제공합니다.

api 상세
개요

중기예보란 예보일로부터 4일(최대5일)에서 10일까지의 기간에 대한 예보를 뜻합니다. 4일(최대5일)에서 7일까지는 오전과 오후로 구분하여 예보하고, 8일에서 10일까지는 일 단위로 구분하여 예보합니다.

요 소

기상전망, 최고 · 최저기온, 최고 · 최저기온 범위 상 · 하한값, 강수확률, 날씨(강수형태 및 하늘상태), 파고(해상)
지 점

서울 · 인천 · 경기도, 강원도 영서, 강원도 영동, 충청북도, 대전 · 세종 · 충청남도, 전라북도, 광주 · 전라남도, 대구 · 경상북도, 부산 · 울산 · 경상남도, 제주도

보유기간

2012년 12월 18일 18:00KST(시행일기준) ~ 현재
(2013년 10월 15일 18:00KST부터 7일 → 10일 예보기간 연장운영)
※ 신뢰도: 2013년 10월 15일 18:00KST(시행일 기준) ~ 2019년 4월 30일 06:00KST(서비스종료 기준)
※ 강수확률, 최고·최저기온 상·하한 범위: 2019년 4월 30일 18:00KST(시행일 기준) ~ 현재
생산주기

12시간 간격(06, 18시)

1. 중기예보자료(2001년 2월 이후) 조회

1.1 중기 예보구역

https://apihub.kma.go.kr/api/typ01/url/fct_medm_reg.php?tmfc=0&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

tmfc

발표시간

예보구역조회에서 사용(기준시각의미, 년월일시(KST))
없으면, 전체 / 0이면, 가장 최근

authKey

인증키

발급된 API 인증키
출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

REG_ID

예보구역코드

TM_ST

시작시각(년월일시분,KST)

TM_ED

종료시각(년월일시분,KST)

REG_SP

특성

REG_NAME

예보구역명

1.2 중기 개황, disp=1(JSON)

https://apihub.kma.go.kr/api/typ01/url/fct_afs_ws.php?stn=&tmfc1=2013121106&tmfc2=2013121118&disp=0&help=1&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

stn

발표관서번호

없으면 전체

reg

예보구역코드

없으면 전체

tmfc

발표시간

예보구역조회에서 사용(기준시각의미, 년월일시(KST))
없으면, 전체 / 0이면, 가장 최근

tmfc1

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmfc2

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmef1

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

tmef2

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

mode

표출양식

0 : 예보값만 표시(속도 빠름)
1 : 예보관ID, 예보관명, 예보구역명 포함

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키
출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

REG_ID

예보구역코드

TM_ST

시작시각(년월일시분,KST)

TM_ED

종료시각(년월일시분,KST)

REG_SP

특성

REG_NAME

예보구역명

STN_ID

발표관서

TM_FC

발표시각(KST)

TM_IN

입력시각(KST)

CNT

참조번호

MAN_FC

예보관명

TM_EF

발효시각(년월일시분,KST)

MOD

구간 (A01(24시간),A02(12시간))

STN

발표관서

C

발표코드

MAN_ID

예보관ID

SKY

하늘상태코드 (WB01(맑음),WB02(구름조금),WB03(구름많음),WB04(흐림))

PRE

강수유무코드 (WB09(비),WB11(비/눈),WB13(눈/비),WB12(눈))

CONF

신뢰도

WF

예보

RN_ST

강수확률

MIN

아침최저기온

MAX

낮최고기온

MIN_L

아침최저기온 하한 기온범위

MIN_H

아침최저기온 상한 기온범위

MAX_L

낮최고기온 하한 기온범위

MAX_H

낮최고기온 상한 기온범위

WH_A

파고1(m)

WH_B

파고2(m)

1.3 중기 육상예보

https://apihub.kma.go.kr/api/typ01/url/fct_afs_wl.php?reg=&tmfc1=2013121106&tmfc2=2013121118&tmef1=20131214&tmef2=20131219&disp=0&help=1&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

stn

발표관서번호

없으면 전체

reg

예보구역코드

없으면 전체

tmfc

발표시간

예보구역조회에서 사용(기준시각의미, 년월일시(KST))
없으면, 전체 / 0이면, 가장 최근

tmfc1

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmfc2

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmef1

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

tmef2

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키
출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

REG_ID

예보구역코드

TM_ST

시작시각(년월일시분,KST)

TM_ED

종료시각(년월일시분,KST)

REG_SP

특성

STN_ID

발표관서

TM_FC

발표시각(KST)

TM_IN

입력시각(KST)

CNT

참조번호

TM_EF

발효시각(년월일시분,KST)

MOD

구간 (A01(24시간),A02(12시간))

STN

발표관서

C

발표코드

SKY

하늘상태코드 (WB01(맑음),WB02(구름조금),WB03(구름많음),WB04(흐림))

PRE

강수유무코드 (WB09(비),WB11(비/눈),WB13(눈/비),WB12(눈))

CONF

신뢰도

WF

예보

RN_ST

강수확률

MIN

아침최저기온

MAX

낮최고기온

MIN_L

아침최저기온 하한 기온범위

MIN_H

아침최저기온 상한 기온범위

MAX_L

낮최고기온 하한 기온범위

MAX_H

낮최고기온 상한 기온범위

WH_A

파고1(m)

WH_B

파고2(m)

1.4 중기 기온예보

https://apihub.kma.go.kr/api/typ01/url/fct_afs_wc.php?reg=&tmfc1=2013121106&tmfc2=2013121118&tmef1=20131214&tmef2=20131219&disp=0&help=1&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

stn

발표관서번호

없으면 전체

reg

예보구역코드

없으면 전체

tmfc

발표시간

예보구역조회에서 사용(기준시각의미, 년월일시(KST))
없으면, 전체 / 0이면, 가장 최근

tmfc1

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmfc2

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmef1

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

tmef2

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키
출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

REG_ID

예보구역코드

TM_ST

시작시각(년월일시분,KST)

TM_ED

종료시각(년월일시분,KST)

REG_SP

특성

STN_ID

발표관서

TM_FC

발표시각(KST)

TM_IN

입력시각(KST)

CNT

참조번호

TM_EF

발효시각(년월일시분,KST)

MOD

구간 (A01(24시간),A02(12시간))

STN

발표관서

C

발표코드

SKY

하늘상태코드 (WB01(맑음),WB02(구름조금),WB03(구름많음),WB04(흐림))

PRE

강수유무코드 (WB09(비),WB11(비/눈),WB13(눈/비),WB12(눈))

CONF

신뢰도

WF

예보

RN_ST

강수확률

MIN

아침최저기온

MAX

낮최고기온

MIN_L

아침최저기온 하한 기온범위

MIN_H

아침최저기온 상한 기온범위

MAX_L

낮최고기온 하한 기온범위

MAX_H

낮최고기온 상한 기온범위

WH_A

파고1(m)

WH_B

파고2(m)

1.5 중기 해상예보

https://apihub.kma.go.kr/api/typ01/url/fct_afs_wo.php?reg=&tmfc1=2013121106&tmfc2=2013121118&tmef1=20131214&tmef2=20131219&disp=0&help=1&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

stn

발표관서번호

없으면 전체

reg

예보구역코드

없으면 전체

tmfc

발표시간

예보구역조회에서 사용(기준시각의미, 년월일시(KST))
없으면, 전체 / 0이면, 가장 최근

tmfc1

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmfc2

발표시간
(기간)

기간: [tmfc1 ~ tmfc2] : 년월일시(KST)
없으면, 가장 최근 발표시간자료

tmef1

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

tmef2

발효시간
(기간)

기간: [tmef1 ~ tmef2] : 년월일시(KST)
없으면, 해당 발표시간에 예보된 기간 전체

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)
1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

1(도움말 정보 표시)

authKey

인증키

발급된 API 인증키
출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

REG_ID

예보구역코드

TM_ST

시작시각(년월일시분,KST)

TM_ED

종료시각(년월일시분,KST)

REG_SP

특성

STN_ID

발표관서

TM_FC

발표시각(KST)

TM_IN

입력시각(KST)

CNT

참조번호

TM_EF

발효시각(년월일시분,KST)

MOD

구간 (A01(24시간),A02(12시간))

STN

발표관서

C

발표코드

SKY

하늘상태코드 (WB01(맑음),WB02(구름조금),WB03(구름많음),WB04(흐림))

PRE

강수유무코드 (WB09(비),WB11(비/눈),WB13(눈/비),WB12(눈))

CONF

신뢰도

WF

예보

RN_ST

강수확률

MIN

아침최저기온

MAX

낮최고기온

MIN_L

아침최저기온 하한 기온범위

MIN_H

아침최저기온 상한 기온범위

MAX_L

낮최고기온 하한 기온범위

MAX_H

낮최고기온 상한 기온범위

WH_A

파고1(m)

WH_B

파고2(m)

2. 중기예보 조회

중기예보 조회서비스_오픈API활용가이드 참고자료

2.1 중기해상예보조회

https://apihub.kma.go.kr/api/typ02/openApi/MidFcstInfoService/getMidSeaFcst?pageNo=1&numOfRows=10&dataType=XML®Id=12A20000&tmFc=201404080600&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

regId

예보구역코드

12A20000 서해중부, 12B10000 남해서부등.. 하단 참고자료 참조

tmFc

발표시각

-일 2회(06:00,18:00)회 생성 되며 발표시각을 입력- YYYYMMDD0600(1800) 최근 24시간 자료만 제공

authKey

인증키

발급된 API 인증키
출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

regId

예보구역코드

wf4Am

4일후 오전날씨예보

wf4Pm

4일후 오후날씨예보

wf5Am

5일후 오전날씨예보

wf5Pm

5일후 오후날씨예보

wf6Am

6일후 오전날씨예보

wf6Pm

6일후 오후날씨예보

wf7Am

7일후 오전날씨예보

wf7Pm

7일후 오후날씨예보

wf8

8일후 날씨예보

wf9

9일후 날씨예보

wf10

10일후 날씨예보

wh3AAm

3일후 오전 최저 예상파고(m)

wh3APm

3일후 오후 최저 예상파고(m)

wh3BAm

3일후 오전 최고 예상파고(m)

wh3BPm

3일후 오후 최고

wh4AAm

4일후 오전 최저

wh4APm

4일후 오후 최저

wh4BAm

4일후 오전 최고

wh4BPm

4일후 오후 최고

wh5AAm

5일후 오전 최저

wh5APm

5일후 오후 최저

wh5BAm

5일후 오전 최고

wh5BPm

5일후 오후 최고

wh6AAm

6일후 오전 최저

wh6APm

6일후 오후 최저

wh6BAm

6일후 오전 최고

wh6BPm

6일후 오후 최고

wh7AAm

7일후 오전 최저

wh7APm

7일후 오후 최저

wh7BAm

7일후 오전 최고

wh7BPm

7일후 오후 최고

wh8A

8일후 최저예상파고(m)

wh8B

8일후 최고 예상파고(m)

wh9A

9일후 최저예상파고(m)

wh9B

9일후 최고 예상파고(m)

wh10A

10일후 최저예상파고(m)

wh10B

10일후 최고 예상파고(m)

2.2 중기기온조회

https://apihub.kma.go.kr/api/typ02/openApi/MidFcstInfoService/getMidTa?pageNo=1&numOfRows=10&dataType=XML®Id=11B10101&tmFc=201309030600&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

regId

예보구역코드

11B10101 서울, 11B20201 인천 등 ( 별첨엑셀자료 참고)

tmFc

발표시각

-일 2회(06:00,18:00)회 생성 되며 발표시각을 입력- YYYYMMDD0600(1800) 최근 24시간 자료만 제공

authKey

인증키

발급된 API 인증키
출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

regId

예보구역코드

taMin4

4일 후 예상최저기온(℃)

taMin4Low

4일 후 예상최저기온 하한 범위

taMin4High

4일 후 예상최저기온 상한 범위

taMax4

4일 후 예상최고기온(℃)

taMax4Low

4일 후 예상최고기온 하한 범위

taMax4High

4일 후 예상최고기온 상한 범위

taMin5

5일 후 예상최저기온(℃)

taMin5Low

5일 후 예상최저기온 하한 범위

taMin5High

5일 후 예상최저기온 상한 범위

taMax5

5일 후 예상최고기온(℃)

taMax5Low

5일 후 예상최고기온 하한 범위

taMax5High

5일 후 예상최고기온 상한 범위

taMin6

6일 후 예상최저기온(℃)

taMin6Low

6일 후 예상최저기온 하한 범위

taMin6High

6일 후 예상최저기온 상한 범위

taMax6

6일 후 예상최고기온(℃)

taMax6Low

6일 후 예상최고기온 하한범위

taMax6High

6일 후 예상최고기온 상한범위

taMin7

7일 후 예상최저기온(℃)

taMin7Low

7일 후 예상최저기온 하한범위

taMin7High

7일 후 예상최저기온 상한범위

taMax7

7일 후 예상최고기온(℃)

taMax7Low

7일 후 예상최고기온 하한범위

taMax7High

7일 후 예상최고기온 상한범위

taMin8

8일 후 예상최저기온(℃)

taMin8Low

8일 후 예상최저기온 하한범위

taMin8High

8일 후 예상최저기온 상한범위

taMax8

8일 후 예상최고기온(℃)

taMax8Low

8일 후 예상최고기온 하한범위

taMax8High

8일 후 예상최고기온 상한범위

taMin9

9일 후 예상최저기온(℃)

taMin9Low

9일 후 예상최저기온 하한범위

taMin9High

9일 후 예상최저기온 상한범위

taMax9

9일 후 예상최고기온(℃)

taMax9Low

9일 후 예상최고기온 하한범위

taMax9High

9일 후 예상최고기온 상한범위

taMin10

10일 후 예상최저기온(℃)

taMin10Low

10일 후 예상최저기온 하한범위

taMin10High

10일 후 예상최저기온 상한범위

taMax10

10일 후 예상최고기온(℃)

taMax10Low

10일 후 예상최고기온 하한범위

taMax10High

10일 후 예상최고기온 상한범위

2.3 중기육상예보조회

https://apihub.kma.go.kr/api/typ02/openApi/MidFcstInfoService/getMidLandFcst?pageNo=1&numOfRows=10&dataType=XML®Id=11B00000&tmFc=202107300600&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

regId

예보구역코드

11B0000 서울, 인천, 경기도 11D10000 등 (활용가이드 하단 참고자료 참조)

tmFc

발표시각

-일 2회(06:00,18:00)회 생성 되며 발표시각을 입력 YYYYMMDD0600(1800)-최근 24시간 자료만 제공

authKey

인증키

발급된 API 인증키
출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

regid

예보구역코드

rnSt4Am

4일 후 오전 강수 확률

rnSt4Pm

4일 후 오후 강수 확률

rnSt5Am

5일 후 오전 강수 확률

rnSt5Pm

5일 후 오후 강수 확률

rnSt6Am

6일 후 오전 강수 확률

rnSt6Pm

6일 후 오후 강수 확률

rnSt7Am

7일 후 오전 강수 확률

rnSt7Pm

7일 후 오후 강수 확률

rnSt8

8일 후 강수 확률

rnSt9

9일 후 강수 확률

rnSt10

10일 후 강수 확률

wf3Am

3일 후 오전 날씨예보

wf3Pm

3일 후 오후 날씨예보

wf4Am

4일 후 오전 날씨예보

wf4Pm

4일 후 오후 날씨예보

wf5Am

5일 후 오전 날씨예보

wf5Pm

5일 후 오후 날씨예보

wf6Am

6일 후 오전 날씨예보

wf6Pm

6일 후 오후 날씨예보

wf7Am

7일 후 오전 날씨예보

wf7Pm

7일 후 오후 날씨예보

wf8

8일 후 날씨예보

wf9

9일 후 날씨예보

wf10

10일 후 날씨예보

2.4 중기전망조회

https://apihub.kma.go.kr/api/typ02/openApi/MidFcstInfoService/getMidFcst?pageNo=1&numOfRows=10&dataType=XML&stnId=108&tmFc=201310170600&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

stnId

지점번호

108 전국, 109 서울, 인천, 경기도 등 (활용가이드 하단 참고자료 참조)

tmFc

발표시각

-일 2회(06:00,18:00)회 생성 되며 발표시각을 입력 YYYYMMDD0600 (1800)-최근 24시간 자료만 제공

authKey

인증키

발급된 API 인증키
출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

wfSv

기상전망