指南

调用 REST API

两个 GET 路由，一种响应结构。任何 HTTP 客户端都能用，任何浏览器来源都可以调用。

基础 URL

URL

https://api.waity.ai

GET /v1/places

提供以下之一：位置（near=lat,lng 或 X-Waity-Location 请求头）、q（地点名称、城市、机场代码、ZIP，或像“布鲁克林附近的急诊室”这样的直白提问），或 ids。可选：category、open、sort、limit 和 view。

curl "https://api.waity.ai/v1/places?q=El+Paso&category=border&view=minimal"

GET /v1/places/{id}

可选：under（分钟）、travel_min（会添加 next.leave_by）、date（最多提前 7 天）、forecast 和 view。机场、边境口岸或医院院区的 id 会返回其中的通道或科室。

curl

curl "https://api.waity.ai/v1/places/pl_xaed7pr1f5?travel_min=15&view=minimal"

不使用密钥也能调用。有密钥时，以 X-Api-Key 或 Authorization: Bearer 发送。

curl "https://api.waity.ai/v1/places/pl_xaed7pr1f5?view=minimal" \
  -H "X-Api-Key: $WAITY_API_KEY"

view=minimal 只返回要点，是完整视图的严格子集：相同的键、相同的路径，只是更少。MCP 工具默认使用它。

所有路由、参数和响应都在API 参考中；schema 为 openapi.json。