# 예특보 API 목록 (09-forecast-warning) - 기상청 API허브

> 기상청 API허브 '예특보' 분류의 API 43개 목록입니다. 항목마다 API 이름(명세 주소 연결), 요청 주소, 설명 순서로 적었습니다.
> 필요한 API 를 고른 뒤 연결된 명세(OpenAPI 3.0.3 yml)를 열면 요청 인자와 응답 형식을 볼 수 있습니다.

- 호출 방법·인증키 안내: https://apihub.kma.go.kr/llms.txt
- 모든 요청은 HTTP GET 이며 인증키를 `authKey` 쿼리 인자로 붙입니다.

## 01-short-term-forecast / 01-short-term-forecast-since-2001

- [단기 예보구역 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/01-short-term-forecast-since-2001/01-short-term-forecast-zone.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/fct_shrt_reg.php` - 단기예보를 발표하는 예보구역의 코드·명칭·발표관서 등 구역 정보를 조회하는 서비스
- [단기 기상개황 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/01-short-term-forecast-since-2001/02-short-term-weather-outline.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/fct_afs_ds.php` - 발표관서별 단기예보 기상개황(종합 예보 문구)을 조회하는 서비스
- [단기 육상예보 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/01-short-term-forecast-since-2001/03-short-term-land-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/fct_afs_dl.php` - 육상 예보구역별 단기 육상예보(풍향·기온·강수확률·하늘 상태 등)를 조회하는 서비스
- [단기 육상예보(확장) 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/01-short-term-forecast-since-2001/04-short-term-land-forecast-extended.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/fct_afs_dl2.php` - 단기 육상예보를 조회하는 서비스로, 2020년 이후 발표 체계에 대응하는 확장 버전
- [단기 해상예보 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/01-short-term-forecast-since-2001/05-short-term-sea-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/fct_afs_do.php` - 해상 예보구역별 단기 해상예보(풍향·풍속·파고 등)를 조회하는 서비스

## 01-short-term-forecast / 02-village-forecast-grid

- [동네예보 단기예보 격자자료 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/02-village-forecast-grid/01-village-short-term-forecast-grid.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-dfs_shrt_grd` - 전국을 5km 격자(149x253, 총 37,697개)로 나눈 단기예보 격자자료를 예보변수별로 조회하는 서비스
- [동네예보 초단기 예보 격자 자료 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/02-village-forecast-grid/02-village-very-short-forecast-grid.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-dfs_vsrt_grd` - 10분 간격으로 발표되는 초단기 예보 격자 자료를 예보변수별로 조회하는 서비스
- [동네예보 실황 격자자료 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/02-village-forecast-grid/03-village-nowcast-obs-grid.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-dfs_odam_grd`
- [동네예보 격자 번호·위경도 변환 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/02-village-forecast-grid/04-village-forecast-grid-latlon-convert.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-dfs_xy_lonlat` - 동네예보 격자 번호(x, y)를 위·경도로 변환하거나, 임의의 위·경도에 해당하는 인근 동네예보 격자 번호를 조회하는 서비스

## 01-short-term-forecast / 03-village-forecast-bulletin

- [기상개황 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/03-village-forecast-bulletin/01-village-forecast-bulletin.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/VilageFcstMsgService/getWthrSituation` - 발표관서별 기상개황(종합), 특보 사항, 예비특보 통보문을 조회하는 서비스
- [육상예보 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/03-village-forecast-bulletin/02-land-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/VilageFcstMsgService/getLandFcst` - 예보구역별 육상예보 통보문(풍향, 예상기온, 강수확률, 날씨 등)을 조회하는 서비스
- [해상예보 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/03-village-forecast-bulletin/03-sea-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/VilageFcstMsgService/getSeaFcst` - 해상 예보구역별 해상예보 통보문(풍향·풍속, 파고, 날씨 등)을 조회하는 서비스

## 01-short-term-forecast / 04-village-forecast-query

- [초단기실황 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/04-village-forecast-query/01-very-short-nowcast.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/VilageFcstInfoService_2.0/getUltraSrtNcst` - 동네예보 격자 지점(nx, ny)의 초단기 실황 값을 조회하는 서비스
- [초단기예보 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/04-village-forecast-query/02-very-short-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/VilageFcstInfoService_2.0/getUltraSrtFcst` - 동네예보 격자 지점(nx, ny)의 초단기예보 값을 예측 시각별로 조회하는 서비스
- [단기예보 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/04-village-forecast-query/03-short-term-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/VilageFcstInfoService_2.0/getVilageFcst` - 동네예보 격자 지점(nx, ny)의 단기예보 값을 예보 시각별로 조회하는 서비스
- [예보 버전 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/04-village-forecast-query/04-forecast-version.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/VilageFcstInfoService_2.0/getFcstVersion` - 동네예보 실황·초 단기예보·단기예보 파일의 최종 생성 시각(버전)을 조회하여 자료 갱신 여부를 확인하는 서비스

## 01-short-term-forecast / 05-graphic-village-forecast-map

- [동네예보 단기예보 분포도 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/05-graphic-village-forecast-map/01-village-short-term-forecast-dist-map.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/dfs/nph-dfs_shrt_ana_5d` - 단기예보 격자 자료를 지도 위에 표출한 분포도 이미지를 조회하는 서비스

## 01-short-term-forecast / 06-graphic-very-short-forecast-map

- [동네예보 초 단기예보 분포도 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/06-graphic-very-short-forecast-map/01-village-very-short-forecast-dist-map.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/dfs/nph-dfs_vsrt_ana2` - 초 단기예보 격자 자료를 지도 위에 표출한 분포도 이미지를 조회하는 서비스

## 01-short-term-forecast / 07-village-forecast-grid-latlon

- [동네예보 격자 데이터 위경도 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/07-village-forecast-grid-latlon/01-village-forecast-grid-latlon.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-dfs_latlon_api` - 동네예보 격자 전체에 대한 위도 또는 경도 값을 격자 저장 순서대로 조회하는 서비스
- [동네예보 격자 데이터 위·경도 파일(NetCDF) 다운로드 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/01-short-term-forecast/07-village-forecast-grid-latlon/02-village-forecast-grid-latlon-netcdf-download.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/dfs_latlon_file_down.php` - 동네예보 격자의 위·경도 정보를 NetCDF 파일로 내려받는 서비스

## 02-mid-term-forecast / 01-mid-term-forecast-since-2001

- [중기 예보구역 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/02-mid-term-forecast/01-mid-term-forecast-since-2001/01-mid-term-forecast-zone.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/fct_medm_reg.php` - 중기예보를 발표하는 예보구역의 코드·명칭·발표관서 등 구역 정보를 조회하는 서비스
- [중기 기상개황 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/02-mid-term-forecast/01-mid-term-forecast-since-2001/02-mid-term-weather-outline.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/fct_afs_ws.php` - 발표관서별 중기예보 기상개황(기상 전망 문구)을 조회하는 서비스
- [중기 육상예보 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/02-mid-term-forecast/01-mid-term-forecast-since-2001/03-mid-term-land-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/fct_afs_wl.php` - 육상 예보구역별 중기 육상예보(하늘 상태·강수형태·강수확률·최고 최저기온 등)를 조회하는 서비스
- [중기 기온예보 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/02-mid-term-forecast/01-mid-term-forecast-since-2001/04-mid-term-temp-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/fct_afs_wc.php` - 예보구역별 중기 기온예보(아침 최저기온, 낮 최고기온 및 상·하한 범위)를 조회하는 서비스 (2001년 2월 이후 자료 조회)
- [중기 해상예보 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/02-mid-term-forecast/01-mid-term-forecast-since-2001/05-mid-term-sea-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/fct_afs_wo.php` - 해상 예보구역별 중기 해상예보(날씨 및 예상 파고)를 조회하는 서비스 (2001년 2월 이후 자료 조회)

## 02-mid-term-forecast / 02-mid-term-forecast

- [중기 해상예보 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/02-mid-term-forecast/02-mid-term-forecast/01-mid-term-sea-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/MidFcstInfoService/getMidSeaFcst` - 해상 예보구역별 3~10일 후의 해상 날씨 예보와 최저·최고 예상 파고를 조회하는 서비스
- [중기기온 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/02-mid-term-forecast/02-mid-term-forecast/02-mid-term-temp.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/MidFcstInfoService/getMidTa` - 예보구역별로 4~10일 후의 예상 최저·최고기온과 그 상·하한 범위를 조회하는 서비스
- [중기육상예보 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/02-mid-term-forecast/02-mid-term-forecast/03-mid-term-land-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/MidFcstInfoService/getMidLandFcst` - 육상 예보구역별로 3~10일 후의 날씨 예보와 강수확률을 조회하는 서비스
- [중기 전망 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/02-mid-term-forecast/02-mid-term-forecast/04-mid-term-outlook.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/MidFcstInfoService/getMidFcst` - 지점(발표관서)별 중기 기상 전망 문구를 조회하는 서비스

## 03-weather-warning / 01-warning-info-data

- [특보구역 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/03-weather-warning/01-warning-info-data/01-warning-zone.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/wrn_reg.php` - 기상특보를 발표하는 특보구역의 코드·명칭·상위구역 등 구역 정보를 조회하는 서비스
- [특보자료 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/03-weather-warning/01-warning-info-data/02-warning-data.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/wrn_met_data.php` - 지정한 기간·특보 종류·특보구역에 해당하는 기상특보 발표 이력을 조회하는 서비스
- [기상정보 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/03-weather-warning/01-warning-info-data/03-weather-information.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/wrn_inf_rpt.php` - 발표관서별 기상정보 통보문을 기간 단위로 조회하는 서비스
- [날씨 해설 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/03-weather-warning/01-warning-info-data/04-weather-commentary.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/wthr_cmt_rpt.php` - 발표관서별 날씨 해설 통보문을 기간 및 부제목 코드 단위로 조회하는 서비스

## 03-weather-warning / 02-warning-status

- [특보현황 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/03-weather-warning/02-warning-status/01-warning-status.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/wrn_now_data.php` - 기준시각을 기준으로 현재 발표(또는 발효) 중인 기상특보 현황을 구역별로 조회하는 서비스
- [특보현황 조회 서비스(신규)](https://apihub.kma.go.kr/specs/09-forecast-warning/03-weather-warning/02-warning-status/02-warning-status-new.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/wrn_now_data_new.php` - 특보현황을 조회하는 서비스의 신규 버전

## 03-weather-warning / 03-warning-status-image

- [임의지역 특보 이미지 조회](https://apihub.kma.go.kr/specs/09-forecast-warning/03-weather-warning/03-warning-status-image/01-warning-image-by-area.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/wrn/nph-wrn7` - 지정한 위·경도를 중심으로 하는 임의지역의 특보 발표(발효) 현황을 이미지로 조회하는 서비스

## 04-impact-forecast / 01-impact-forecast-status-risk-level

- [영향예보 발표현황 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/04-impact-forecast/01-impact-forecast-status-risk-level/01-impact-forecast-status.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/ifs_fct_pstt.php` - 발표구역별 영향예보 발표현황을 조회하는 서비스로, 기상현상(폭염·한파)과 영향 분야별 위험 수준을 제공

## 04-impact-forecast / 02-impact-forecast-area-count-by-risk

- [영향예보 위험 수준별 발표지역 수 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/04-impact-forecast/02-impact-forecast-area-count-by-risk/01-impact-forecast-area-count-by-risk.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/ifs_ilvl_zone_cnt.php` - 영향예보 위험 수준별로 해당하는 발표지역의 수와 발표구역 코드를 집계하여 조회하는 서비스

## 04-impact-forecast / 03-impact-forecast-risk-map

- [영향예보 위험 수준 분포도 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/04-impact-forecast/03-impact-forecast-risk-map/01-impact-forecast-risk-map.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/ifs_ilvl_dmap.php` - 지정된 발표일의 영향예보 위험 수준 분포도를 조회하는 서비스

## 05-forecast-zone-info / 01-forecast-zone-info

- [예보구역 코드 조회 서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/05-forecast-zone-info/01-forecast-zone-info/01-forecast-zone-code.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/FcstZoneInfoService/getFcstZoneCd` - 예보구역의 코드·명칭(한글/영문)·위경도·해발고도 및 담당 발표관서 정보를 조회하는 서비스

## 05-forecast-zone-info / 02-warning-zone

- [특보구역코드 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/05-forecast-zone-info/02-warning-zone/01-warning-zone-code.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WethrBasicInfoService/getWrnZoneCd` - 기상특보를 발표하는 특보구역의 코드와 구역명을 조회하는 서비스

## 05-forecast-zone-info / 03-aws-warning-zone-code

- [AWS 특보구역 연계정보 조회서비스](https://apihub.kma.go.kr/specs/09-forecast-warning/05-forecast-zone-info/03-aws-warning-zone-code/01-aws-warning-zone-link.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/wrn_reg_aws.php`
- [AWS 특보구역 연계정보 조회서비스(특보구역명 포함)](https://apihub.kma.go.kr/specs/09-forecast-warning/05-forecast-zone-info/03-aws-warning-zone-code/02-aws-warning-zone-link-with-name.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/wrn_reg_aws2.php` - AWS 관측지점별 예보구역·특보구역 연계정보를 특보구역명과 함께 조회하는 서비스
