Anleitungen

Die REST-API aufrufen

Zwei GET-Routen und eine Antwortform. Jeder HTTP-Client funktioniert, und jeder Browser-Origin darf sie aufrufen.

Basis-URL

https://api.waity.ai

Orte finden

GET /v1/places

Gib eines davon an: einen Standort (near=lat,lng oder den Header X-Waity-Location), q (einen Ortsnamen, eine Stadt, einen Flughafencode, eine PLZ oder eine einfache Frage wie „Notaufnahme bei Brooklyn“) oder ids. Optional: category, open, sort, limit und view.

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

Ein Ort

GET /v1/places/{id}

Optional: under (Minuten), travel_min (fügt next.leave_by hinzu), date (bis zu 7 Tage im Voraus), forecast und view. Die ID eines Flughafens, Grenzübergangs oder Klinikgeländes liefert dessen Spuren oder Abteilungen.

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

Authentifizierung

Aufrufe funktionieren ohne Key. Mit Key sendest du ihn als X-Api-Key oder Authorization: Bearer.

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

Ansichten

view=minimal liefert das Wesentliche und ist eine strikte Teilmenge der vollen Ansicht: dieselben Schlüssel, dieselben Pfade, nur weniger davon. Die MCP-Tools nutzen sie standardmäßig.

Referenz

Jede Route, jeder Parameter und jede Antwort steht in der API-Referenz; das Schema ist openapi.json.