# Query Events

## क्वेरी करें और इवेंट्स को फ़िल्टर करें

Vision Events डैशबोर्ड में फ़िल्टर्स का उपयोग करके विशिष्ट इवेंट्स खोजें, या REST API के माध्यम से प्रोग्रामेटिक रूप से उन्हें क्वेरी करें।

### डैशबोर्ड में इवेंट्स ब्राउज़ करें

#### एक Use Case चुनें

Vision Events पेज से, उसके इवेंट्स देखने के लिए किसी Use Case पर क्लिक करें। इवेंट्स उल्टे कालानुक्रमिक क्रम में प्रदर्शित होते हैं।

<figure><img src="https://2698615118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2FLHsn28q2dYvdGrScCfC7%2Fimage.png?alt=media&#x26;token=f522aaab-16af-4979-925a-1d10997aafdf" alt="" width="375"><figcaption></figcaption></figure>

#### इवेंट्स फ़िल्टर करें

परिणामों को इन आधारों पर सीमित करने के लिए इवेंट्स सूची के शीर्ष पर मौजूद फ़िल्टर नियंत्रणों का उपयोग करें:

* **तिथि सीमा** — आरंभ और समाप्ति टाइमस्टैम्प
* **इवेंट प्रकार** — quality\_check, inventory\_count, safety\_alert, custom, operator\_feedback
* **डिवाइस** — डिवाइस ID के अनुसार फ़िल्टर करें
* **स्ट्रीम** — स्ट्रीम या कैमरा ID के अनुसार फ़िल्टर करें
* **Workflow** — उस Workflow के अनुसार फ़िल्टर करें जिसने इवेंट्स उत्पन्न किए
* **डिटेक्शन क्लास** — किसी विशिष्ट पहचानी गई ऑब्जेक्ट क्लास के अनुसार फ़िल्टर करें
* **कस्टम मेटाडेटा** — किसी भी कस्टम मेटाडेटा फ़ील्ड और वैल्यू के अनुसार फ़िल्टर करें
* **चेतावनियाँ** — केवल वे इवेंट्स दिखाएँ जिनमें ingestion warnings थीं

<figure><img src="https://2698615118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2FkrZ4GYbY0ENZfG7tpnAX%2Fimage.png?alt=media&#x26;token=78c0fbc4-d9ce-47d6-a859-639311329eec" alt="" width="375"><figcaption></figcaption></figure>

#### इवेंट विवरण देखें

सूची में किसी भी इवेंट पर क्लिक करके उसके पूर्ण विवरण देखें:

* मूल इमेज, जिस पर predictions ओवरले किए गए हैं (detections, classifications, segmentations)
* सभी source metadata (device, stream, workflow)
* इवेंट-प्रकार-विशिष्ट डेटा (उदा. pass/fail परिणाम, item count, alert severity)
* कस्टम मेटाडेटा key-value pairs

<figure><img src="https://2698615118-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2FQvgUZXvbdclpG1Ks3a4c%2Fimage.png?alt=media&#x26;token=3b0938bb-a1d0-43d9-bf47-b072be8b98a5" alt="" width="375"><figcaption></figcaption></figure>

### API के माध्यम से इवेंट्स क्वेरी करें

query endpoint डैशबोर्ड के समान फ़िल्टर्स का समर्थन करता है, साथ ही cursor-based pagination भी। पैरामीटर और response fields की पूरी सूची के लिए देखें [Vision Events API Reference](https://docs.roboflow.com/developer/rest-api/vision-events).

#### बुनियादी क्वेरी

```bash
curl -X POST "https://api.roboflow.com/vision-events/query" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "useCaseId": "assembly-line-qa",
    "startTime": "2026-03-01T00:00:00Z",
    "endTime": "2026-03-31T23:59:59Z",
    "limit": 25
  }'
```

**प्रतिक्रिया:**

```json
{
  "events": [
    {
      "eventId": "evt-789ghi",
      "eventType": "quality_check",
      "timestamp": "2026-03-30T14:30:00.000Z",
      "deviceId": "factory-cam-01",
      "streamId": "line-3",
      "images": [],
      "eventData": { "result": "fail" },
      "customMetadata": {
        "line_id": "line-3",
        "shift": "morning",
        "part_number": "PN-4421"
      }
    }
  ],
  "nextCursor": "eyJ0cyI6IjIwMjYtMDMtMzAifQ==",
  "hasMore": true
}
```

#### पेजिनेशन

परिणामों को cursor का उपयोग करके पेजिनेट किया जाता है। यदि response में शामिल हो `nextCursor` मान और `hasMore` है `true`, तो अगले पेज को प्राप्त करने के लिए अपनी अगली request में cursor पास करें:

```bash
curl -X POST "https://api.roboflow.com/vision-events/query" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "useCaseId": "assembly-line-qa",
    "limit": 25,
    "cursor": "eyJ0cyI6IjIwMjYtMDMtMzAifQ=="
  }'
```

तब तक जारी रखें जब तक `hasMore` है `false`.

#### इवेंट प्रकार के अनुसार फ़िल्टर करें

एकल इवेंट प्रकार को क्वेरी करें:

```json
{
  "useCaseId": "assembly-line-qa",
  "eventType": "quality_check"
}
```

या कई इवेंट प्रकार (अधिकतम 20):

```json
{
  "useCaseId": "assembly-line-qa",
  "eventTypes": ["quality_check", "operator_feedback"]
}
```

#### कस्टम मेटाडेटा के अनुसार फ़िल्टर करें

उपयोग करें `customMetadataFilters` अपने स्वयं के मेटाडेटा फ़ील्ड्स के आधार पर इवेंट्स फ़िल्टर करने के लिए:

```json
{
  "useCaseId": "assembly-line-qa",
  "customMetadataFilters": [
    { "key": "line_id", "operator": "eq", "value": "line-3" },
    { "key": "shift", "operator": "eq", "value": "morning" }
  ]
}
```