गाइड

REST API कॉल करें

दो GET रूट और जवाब का एक ही आकार। कोई भी HTTP क्लाइंट चलेगा, और कोई भी ब्राउज़र origin इसे कॉल कर सकता है।

बेस URL

https://api.waity.ai

जगहें खोजें

GET /v1/places

इनमें से एक दें: लोकेशन (near=lat,lng या X-Waity-Location हेडर), q (जगह का नाम, शहर, एयरपोर्ट कोड, ZIP या सीधा सवाल जैसे “Brooklyn के पास ER”), या 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 "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 ज़रूरी चीज़ें लौटाता है और पूरे व्यू का सख़्त उपसमूह है: वही keys, वही paths, बस कम। MCP टूल डिफ़ॉल्ट रूप से इसी का इस्तेमाल करते हैं।

रेफ़रेंस

हर रूट, पैरामीटर और जवाब API रेफ़रेंस में है; स्कीमा openapi.json है।