Guías
Llamar a la API REST
Dos rutas GET y una sola forma de respuesta. Funciona cualquier cliente HTTP, y cualquier origen de navegador puede llamarla.
URL base
URL
https://api.waity.ai
Buscar lugares
GET /v1/places
Da uno de estos: una ubicación (near=lat,lng o el encabezado X-Waity-Location), q (el nombre de un lugar, una ciudad, un código de aeropuerto, un código postal o una petición sencilla como “urgencias cerca de Brooklyn”) o ids. Opcional: category, open, sort, limit y view.
curl "https://api.waity.ai/v1/places?q=El+Paso&category=border&view=minimal"
Un lugar
GET /v1/places/{id}
Opcional: under (minutos), travel_min (añade next.leave_by), date (hasta 7 días por adelantado), forecast y view. El id de un aeropuerto, un puerto fronterizo o un campus hospitalario devuelve sus carriles o departamentos.
curl
curl "https://api.waity.ai/v1/places/pl_xaed7pr1f5?travel_min=15&view=minimal"
Autenticación
Las llamadas funcionan sin clave. Con una clave, envíala como X-Api-Key o Authorization: Bearer.
curl "https://api.waity.ai/v1/places/pl_xaed7pr1f5?view=minimal" \
-H "X-Api-Key: $WAITY_API_KEY"
Vistas
view=minimal devuelve lo esencial y es un subconjunto estricto de la vista completa: las mismas claves en las mismas posiciones, solo que menos. Las herramientas MCP la usan por defecto.
Referencia
Cada ruta, parámetro y respuesta está en la Referencia de la API; el esquema es openapi.json.