指南
等候歷史
某個地點過去公布的等候時間:按小時或按天的平均值,或每一筆讀數。歷史只描述過去,絕不預測就診或到訪。
取得歷史
以地點 id 呼叫 GET /v1/places/{id}/history,或使用 get_history 工具。不傳 from 與 to 時,回傳最近 7 天的逐小時資料。
curl "https://api.waity.ai/v1/places/pl_xaed7pr1f5/history?granularity=day&from=2026-10-01" \
-H "X-Api-Key: $WAITY_API_KEY"
粒度
hour | 每個有資料的小時一列:avg、median、p90、min、max、公布更新次數,以及該小時內地點開放的比例。 |
day | 每個當地日期一列,同樣的數據依開放時長加權。 |
raw | 每一筆公布的讀數,包含時間、範圍、口徑與來源。 |
時間範圍與分頁
from 與 to 接受日期(依地點當地時間)或 ISO 日期時間;to 中的日期表示當天結束。較長的範圍會分頁回傳:傳入 page.next_cursor 中的 cursor 取得下一頁。
可回溯多久
查看歷史需要 API 金鑰。超出方案可回溯範圍的請求會被截短,而不是拒絕:range.clipped 為 true,回答中也會說明。
| 方案 | 可回溯 |
|---|---|
| Free | 30 天 |
| Plus | 365 天 |
| Pro | 365 天 |
| Team | 全部 |
急診歷史
過去的急診等候時間只描述當時公布的內容,不能預測現在就診的情況:遇到緊急情況,請前往最近的急診室或撥打 911。