han-river-water-level

Han River Water Level

此技能功能

預設向 https://k-skill-proxy.nomadamas.org/v1/han-river/water-level 發送請求，取得當前水位與流量摘要。

使用時機

• "漢江大橋現在水位如何？"
• "告訴我潛水橋的流量"
• "顯示觀測站 1018683 的當前數值"

輸入

• 預設輸入：觀測站名稱/橋樑名稱 (stationName)
• 替代輸入：觀測站代碼 (stationCode)

前置需求

• 可選：jq

預設路徑

無需額外 client API 層，直接對代理伺服器發送 HTTP 請求即可。

使用者無需準備獨立的 HRFCO ServiceKey，上游金鑰僅由代理伺服器注入。

若存在 KSKILL_PROXY_BASE_URL 環境變數則使用該值，否則使用預設路徑 https://k-skill-proxy.nomadamas.org。

範例請求

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/han-river/water-level' \
  --data-urlencode 'stationName=한강대교'

也可直接以觀測站代碼查詢。

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/han-river/water-level' \
  --data-urlencode 'stationCode=1018683'

保持回答簡潔

回應中先整理以下資訊：

• 觀測站名稱 / 觀測站代碼
• 觀測時間
• 當前水位 (m)
• 當前流量 (m^3/s)
• 基準水位（關注/注意/警報/嚴重）中有值的項目

模糊的觀測站名稱

若輸入範圍過廣，代理伺服器會回傳 ambiguous_station 及 candidate_stations。

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/han-river/water-level' \
  --data-urlencode 'stationName=한강'

此時請從候選中選擇一個，再以 stationName 或 stationCode 重新查詢。

詳細 API 路徑

實作細節請參考以下文件：

• docs/features/han-river-water-level.md
• docs/features/k-skill-proxy.md

失敗模式

• 觀測站名稱過於廣泛，同時命中多個觀測站
• 觀測站代碼或名稱錯誤，導致查詢失敗
• 代理伺服器缺少 HRFCO_OPEN_API_KEY
• 即時資料更新延遲，導致最近 10 分鐘資料為空

備註

• 預設路徑始終為 k-skill-proxy.nomadamas.org 的 water-level endpoint。
• 上游透過 waterlevel/info.json 查找觀測站中繼資料，並以 waterlevel/list/10M/{WLOBSCD}.json 取得最新數值。
• 結果基於原始資料，因此請一併記錄查詢時間。