फ़ीचर

एजेंट रिपोर्ट

एजेंट और ऐप वह प्रतीक्षा रिपोर्ट कर सकते हैं जो उनके उपयोगकर्ता ने अभी झेली। रिपोर्ट उन जगहों को भरती हैं जहाँ कोई लाइव प्रकाशित प्रतीक्षा नहीं है, हमेशा रिपोर्ट की गई के रूप में दिखती हैं, और ER या अर्जेंट केयर के लिए कभी नहीं ली जातीं।

यह क्या है

POST /v1/places/{id}/reports और report_wait टूल वह प्रतीक्षा सहेजते हैं जो किसी ने असल में झेली। रिपोर्ट प्रकाशित प्रतीक्षा से अलग रखी जाती हैं: उनका अपना स्तर agent है, और वे किसी आधिकारिक या जगह की प्रकाशित संख्या से कभी नहीं मिलाई जातीं।

रिपोर्ट कैसे करें

विज़िट के तुरंत बाद उपयोगकर्ता के इंतज़ार के मिनट भेजें। रिपोर्ट के लिए API की ज़रूरी है और यह एक कॉल गिनी जाती है।

wait_min: मिनट, 0 से 600। ज़रूरी।
observed_at: उपयोगकर्ता ने कब इंतज़ार किया, ऑफ़सेट के साथ ISO 8601, पिछले 2 घंटों के भीतर। डिफ़ॉल्ट: अभी।
kind: लाइन में रहते हुए in_line (अब तक की प्रतीक्षा), या अभी खत्म हुई पूरी प्रतीक्षा के लिए done।

curl -X POST "https://api.waity.ai/v1/places/pl_nvk0wkb3ps/reports" \
  -H "X-Api-Key: $WAITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"wait_min":25,"kind":"done"}'

सहेजी गई रिपोर्ट 201 के साथ अपनी report.id और shown लौटाती है। न दिखे तो reason बताता है क्यों: needs_more_reports, official_wait, closed, too_old या out_of_range।

MCP टूल

report_wait वही फ़ील्ड और जगह की id लेता है। यह लिखने वाला अकेला MCP टूल है, इसलिए इसके एनोटेशन बताते हैं कि यह सिर्फ़ पढ़ने वाला नहीं है।

रिपोर्ट कब दिखती हैं

सिर्फ़ तब, जब जगह पर कोई इस्तेमाल लायक आधिकारिक या जगह की प्रकाशित प्रतीक्षा न हो और जगह बंद न हो। लाइव प्रकाशित प्रतीक्षा हमेशा आगे रहती है; रिपोर्ट इतिहास में रहती है।
सिर्फ़ तब, जब पिछले 45 मिनट में कम से कम 2 अलग लोगों ने रिपोर्ट या पुष्टि की हो, या किसी भरोसेमंद व्यक्ति ने (जिसकी पिछली रिपोर्टों की दूसरों ने पुष्टि की हो)।
दिखाई गई प्रतीक्षा हर व्यक्ति की सबसे नई रिपोर्ट का माध्यिका है। विंडो में 2 से कम लोग बचने पर यह दिखना बंद हो जाती है।

इन्हें कैसे दिखाया जाता है

रिपोर्ट की गई प्रतीक्षा में now.tier: "agent", now.basis: "reported" और now.source.name: "people" होते हैं, अपने अलग now.source.short के साथ। इसका सारांश बताता है कि इसे लोगों ने रिपोर्ट किया ("reported by 2 people") और जगह ने इसे प्रकाशित नहीं किया।

रिपोर्ट किए गए मिनटों की तुलना कभी प्रकाशित मिनटों से नहीं होती: दोनों वाली सूची यह बताती है, और instead कभी एक को दूसरे से छोटा नहीं बताता।

ER या अर्जेंट केयर के लिए कभी नहीं

वहाँ की रिपोर्ट 422 reports_not_accepted के साथ लौटा दी जाती है, और कुछ भी सहेजा नहीं जाता।

सीमाएँ और निजता

बिना की वाली कॉल को 401 key_required मिलता है; वे गिनी नहीं जातीं।
हर रिपोर्टर के लिए हर जगह पर 30 मिनट में एक रिपोर्ट (429 report_too_soon, Retry-After के साथ)।
हर रिपोर्टर के लिए दिन में 200 रिपोर्ट (429 report_limit, UTC आधी रात तक)।
रिपोर्ट के साथ सिर्फ़ की का id सहेजा जाता है। नाम, फ़ोन नंबर या कोई और निजी जानकारी न भेजें।

रिपोर्ट पार्टनर, जैसे एक टेक्स्ट मैसेज सेवा जो एक की से कई लोगों की रिपोर्ट भेजती है, reporter भेज सकते हैं: हर व्यक्ति का स्थिर एकतरफ़ा हैश, कभी असली फ़ोन नंबर या ईमेल नहीं। पार्टनर की Waity सेट करता है; किसी और की का reporter अनदेखा किया जाता है।

इतिहास में

रिपोर्ट tier=agent के साथ इतिहास में होती हैं: raw में हर रिपोर्ट, और घंटेवार या दिनवार आँकड़े उसी तरह बने जैसे प्रकाशित प्रतीक्षा के।