指南
等候历史
某个地点过去公布的等候时间:按小时或按天的平均值,或每一条读数。历史只描述过去,绝不预测就诊或到访。
获取历史
用地点 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。