한국 날씨를 기상청 단기예보 조회서비스와 프록시 경유로 조회해 요약한다.
기상청 단기예보 조회서비스를 k-skill-proxy 경유로 조회해서 한국 날씨를 요약한다.
사용자는 개인 OpenAPI key를 직접 발급할 필요가 없고, proxy 서버에만 KMA_OPEN_API_KEY 를 둔다.
jqKSKILL_PROXY_BASE_URLKSKILL_PROXY_BASE_URL (필수: self-host 또는 배포 확인이 끝난 proxy base URL)사용자가 공공데이터포털 기상청 API key를 직접 다룰 필요는 없다. 대신 /v1/korea-weather/forecast route가 실제로 올라와 있는 proxy URL 을 KSKILL_PROXY_BASE_URL 로 받는다. upstream KMA_OPEN_API_KEY 는 proxy 서버에서만 관리한다.
nx, nylat, lonbaseDate, baseTimebaseDate / baseTime 을 생략하면 proxy 가 KST 기준 최신 단기예보 발표 시각을 자동으로 고른다.
KSKILL_PROXY_BASE_URL 로 self-host 또는 배포 확인이 끝난 proxy base URL 을 확인한다.
격자 좌표가 이미 있으면 그대로 넣고, 위도/경도만 있으면 proxy 에 그대로 넘긴다.
curl -fsS --get 'https://your-proxy.example.com/v1/korea-weather/forecast' \
--data-urlencode 'lat=37.5665' \
--data-urlencode 'lon=126.9780'
격자 좌표 예시:
curl -fsS --get 'https://your-proxy.example.com/v1/korea-weather/forecast' \
--data-urlencode 'nx=60' \
--data-urlencode 'ny=127' \
--data-urlencode 'baseDate=20260405' \
--data-urlencode 'baseTime=0500'
가능하면 아래 항목만 먼저 요약한다.
TMP: 기온SKY: 하늘상태PTY: 강수형태POP: 강수확률PCP: 강수량SNO: 적설REH: 습도WSD: 풍속응답에는 조회 시점과 baseDate / baseTime 도 함께 적는다.
KSKILL_PROXY_BASE_URL 이 비어 있거나 weather route가 아직 배포되지 않은 경우nx / ny 또는 lat / lon 이 불완전한 경우nx / ny 격자를 쓰지만, proxy 는 lat / lon 도 받아 내부에서 격자로 변환한다.TMP, SKY, PTY, POP, PCP, SNO, REH, WSD 등을 중심으로 본다.docs/features/k-skill-proxy.md 를 참고한다.