Guides
Appeler l’API REST
Deux routes GET et une seule forme de réponse. Tout client HTTP fonctionne, et toute origine de navigateur peut l’appeler.
URL de base
URL
https://api.waity.ai
Trouver des lieux
GET /v1/places
Donnez l’un de ces éléments : une position (near=lat,lng ou l’en-tête X-Waity-Location), q (un nom de lieu, une ville, un code d’aéroport, un code postal ou une demande simple comme « urgences près de Brooklyn ») ou ids. Facultatif : category, open, sort, limit et view.
curl "https://api.waity.ai/v1/places?q=El+Paso&category=border&view=minimal"
Un lieu
GET /v1/places/{id}
Facultatif : under (minutes), travel_min (ajoute next.leave_by), date (jusqu’à 7 jours à l’avance), forecast et view. Un id d’aéroport, de poste-frontière ou de campus hospitalier renvoie ses files ou ses services.
curl
curl "https://api.waity.ai/v1/places/pl_xaed7pr1f5?travel_min=15&view=minimal"
Authentification
Les appels fonctionnent sans clé. Avec une clé, envoyez-la en X-Api-Key ou Authorization: Bearer.
curl "https://api.waity.ai/v1/places/pl_xaed7pr1f5?view=minimal" \
-H "X-Api-Key: $WAITY_API_KEY"
Vues
view=minimal renvoie l’essentiel et constitue un sous-ensemble strict de la vue complète : mêmes clés, mêmes chemins, en moins grand nombre. Les outils MCP l’utilisent par défaut.
Référence
Chaque route, chaque paramètre et chaque réponse figure dans la Référence de l’API ; le schéma est openapi.json.