Service
data.go.kr 기반 기상청(KMA) 날씨 프로바이더: 특정 발표에 대한 격자 지점의 단기예보(동네예보)와, 같은 격자 지점의 초단기실황과 초단기예보를 제공합니다.
98.42%30일 가동률평균 응답204ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-weather-forecast/short-forecast | Returns the short-term forecast (단기예보, 동네예보) batch published at one announcement (base_date + base_time) for one 5km grid point (grid_x, grid_y): one row per (category, forecast_date, forecast_time), spanning up to ~3 days ahead across categories such as TMP (temperature), POP (precipitation probability), SKY (sky condition), PTY (precipitation type), REH (humidity), WSD (wind speed), and others. Backed by data.go.kr's KMA short-term forecast service (기상청_단기예보 조회서비스, getVilageFcst). Use when the caller needs the multi-day outlook for a grid point. Do NOT use for the weather observed right now — use korea-weather-forecast:ultra-short-observation instead. Do NOT use when only the next few hours matter — use korea-weather-forecast:ultra-short-forecast instead. base_date/base_time/grid_x/grid_y are all required — KMA publishes only 8 batches per day (base_time must be one of 02:00/05:00/08:00/11:00/14:00/17:00/20:00/23:00 KST) and only for specific grid coordinates, so all four must be known in advance (e.g. from a coordinate-conversion lookup and a recent announcement time). Returns total_count, has_more, and items (forecast_date, forecast_time, category, forecast_value). | |
| POST | /v1/korea-weather-forecast/ultra-short-forecast | Returns KMA ultra-short forecast (초단기예보) rows for one publication time and grid point: one row per (category, forecast_date, forecast_time) covering the next several hours, using the official getUltraSrtFcst endpoint. Use when the caller needs hour-by-hour conditions for the coming hours at a grid point (base_time is an HH:30 KST publication time). Do NOT use for the weather observed right now — use korea-weather-forecast:ultra-short-observation instead. Do NOT use for forecasts beyond the next few hours or for the 8-times-daily short-term batch — use korea-weather-forecast:short-forecast instead. Returns total_count, has_more, and items (forecast_date, forecast_time, category, forecast_value). | |
| POST | /v1/korea-weather-forecast/ultra-short-observation | Returns KMA ultra-short observations (초단기실황) for one hourly observation time and grid point, including category-coded temperature, precipitation, wind, humidity, and related observed values, using the official getUltraSrtNcst endpoint. Use when the caller needs the weather actually observed at a grid point at a given hour (base_time is an hourly HH:00 KST value). Do NOT use for future hours — use korea-weather-forecast:ultra-short-forecast (next few hours) or korea-weather-forecast:short-forecast (up to ~3 days) instead. Returns total_count, has_more, and items with one row per category (base_date, base_time, category, observed_value, grid_x, grid_y). |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
