Service
공식 공공 오픈 API 기반 긴급재난문자(CBS), 기상청 기상특보 목록, 기상청 지진·지진해일 통보문을 정규화해 제공합니다.
94.48%30일 가동률평균 응답256ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-disaster-alert/earthquake-bulletin-summaries | Lists the Korea Meteorological Administration earthquake bulletin index (EqkInfoService getEqkMsgList) for a KST issue-date window. Each row carries a bulletin id (official type code plus issue time), the typed bulletin type (domestic or international information, re-issue, field warning, early warning, rapid report), the ISO 8601 KST issue time, and the published title. Use when you need to know which earthquake bulletins KMA issued recently. Do NOT use when you need epicenter, magnitude, depth or intensity — call earthquake-bulletins instead. Omit both dates to get the widest window KMA serves: today and the three KST calendar days before it; KMA serves nothing older. A quiet window returns data_status=no_data with an empty list; a refused key, an out-of-window start, or malformed data remain errors. Returns paginated rows with the upstream total_count and the window actually queried. | |
| POST | /v1/korea-disaster-alert/earthquake-bulletins | Lists detailed Korea Meteorological Administration earthquake bulletins (EqkInfoService getEqkMsg) for a KST issue-date window: issue and origin times, epicenter latitude/longitude and location, magnitude, depth in kilometers, KMA's published intensity notation, remarks, and the epicenter map image URL. KMA intensity is kept verbatim as its Modified Mercalli (KMA_MMI) notation and is never converted to the Japan Meteorological Agency scale. Use when you need the details of recent earthquakes affecting or reported by Korea. Do NOT use for a compact list of bulletin ids — call earthquake-bulletin-summaries instead. Omit both dates to get the widest window KMA serves: today and the three KST calendar days before it; KMA serves nothing older. A quiet window returns data_status=no_data with an empty list; a refused key, an out-of-window start, or malformed data remain errors. Returns paginated rows with the upstream total_count and the window actually queried. | |
| POST | /v1/korea-disaster-alert/emergency-disaster-messages | Lists official Ministry of the Interior and Safety emergency disaster cell-broadcast messages with send time, affected regions, urgency, disaster category, and message text. IMPORTANT ordering contract: the upstream returns rows OLDEST-FIRST (ascending SN/CRT_DT), so an unfiltered page 1 is the start of the archive (2023), NOT the latest messages — to get recent messages, set created_on_or_after to a recent date and page forward; total_count and page math always apply to the filtered window. Use when a caller needs recent or region-filtered Korean public emergency SMS history for dashboards, local-risk apps, or safety bots. Do NOT use for KMA meteorological warning bulletins — call weather-alerts instead. Returns paginated normalized rows with ISO 8601 KST timestamps. Requires a safetydata service key; results refresh about every minute upstream. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| POST | /v1/korea-disaster-alert/tsunami-bulletins | Lists Korea Meteorological Administration tsunami advisories, warnings, and cancellations (EqkInfoService getTsunamiMsg) for a KST issue-date window, with issue and effective times, affected regions, the announcement text, the source earthquake's origin time, location, coordinates and magnitude, and KMA's safety instructions. Use when you need to know whether KMA has issued a tsunami bulletin for Korea. Do NOT use for earthquake bulletins — call earthquake-bulletins instead. Omit both dates to get the widest window KMA serves: today and the three KST calendar days before it; KMA serves nothing older. No bulletin is the ordinary state: KMA answers it with resultCode 03, returned as data_status=no_data with an empty list; a refused key, an out-of-window start, or malformed data remain errors. Returns paginated rows with the upstream total_count and the window actually queried. |
| POST | /v1/korea-disaster-alert/weather-alerts | Lists Korea Meteorological Administration weather warnings and advisories for a warning station, including issue time, title-derived warning type, severity level, status, and region. Use when a caller needs official KMA weather-warning (기상특보) list data for national station 108 or another KMA station id. Do NOT use for MOIS cell-broadcast emergency SMS — call emergency-disaster-messages instead. Returns paginated normalized rows; empty lists are valid when no warnings are active. Requires a data.go.kr service key registered for the weather-warning open API. |
