指南

呼叫 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。