기상청_단기예보 조회서비스

초단기실황, 초단기예보, 단기((구)동네)예보, 예보버전 정보를 조회하는 서비스입니다. 초단기실황정보는 예보 구역에 대한 대표 AWS 관측값을, 초단기예보는 예보시점부터 6시간까지의 예보를, 단기예보는 예보기간을 글피까지 확장 및 예보단위를 상세화(3시간→1시간)하여 시공간적으로 세분화한 예보를 제공합니다.단기예보는 예보기간과 구역을 시·공간적으로 세분화하여 발표하는 예보입니다. 지역별 시간별 차이로 인한 수요자의 불편을 최소화하기 위해 전국을 5km*5km 간격의 격자로 나누어 읍, 면, 동 단위의 행정구역 중심으로 상세한 날씨를 제공합니다.

결과메시지 결과코드 데이터 타입 발표시각 발표일자 실황 값 예보 값 예보시각 예보일자 예보지점 X 좌표 예보지점 Y 좌표 예측시간 예측일자 자료구분문자 자료구분코드 전체 결과 수 파일구분 파일버전 페이지 번호 한 페이지 결과 수

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '발표시각=값' \
  --data-urlencode '발표일시분=값' \
  --data-urlencode '발표일자=20260101' \
  --data-urlencode '서비스키=값' \
  --data-urlencode '예보지점 X 좌표=값' \
  --data-urlencode '예보지점 Y 좌표=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "발표시각": "값",
  "발표일시분": "값",
  "발표일자": "20260101",
  "서비스키": "값",
  "예보지점 X 좌표": "값",
  "예보지점 Y 좌표": "값",
});

const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "발표시각": "값",
    "발표일시분": "값",
    "발표일자": "20260101",
    "서비스키": "값",
    "예보지점 X 좌표": "값",
    "예보지점 Y 좌표": "값",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())