इवेंट्स भेजें

आपके deployed models से Vision Events भेजने के तीन तरीके।

इवेंट्स भेजें

आप Workflow block, REST API, या edge device backup का उपयोग करके Vision Events भेज सकते हैं.

• Workflow Block - Workflows के उपयोगकर्ताओं को संभवतः आधिकारिक Roboflow block का उपयोग करना सबसे आसान लगेगा

• REST API - जो उपयोगकर्ता models को workflows के बाहर deploy करना चुनते हैं, वे हमारी REST API का उपयोग कर सकते हैं

• Edge Device Backup - Roboflow Edge devices deploy करने वाले उपयोगकर्ताओं के लिए device पर local event store से automated backup configure करना सबसे सुविधाजनक होगा

Workflow Block

अधिकांश उपयोगकर्ताओं के लिए अनुशंसित तरीका. जोड़ें Vision Event block को किसी भी Roboflow Workflow में, ताकि inference results से बिना किसी code की आवश्यकता के events automatically बनाए जा सकें.

सेटअप

1

Workflow Editor खोलें

पर जाएँ Workflows अपने workspace में और वह workflow खोलें जिसमें आप events जोड़ना चाहते हैं.

2

Vision Event Block जोड़ें

block catalog में "Vision Event" खोजें और उसे अपने workflow में जोड़ें.

3

Inputs कनेक्ट करें

image input और model prediction outputs को Vision Event block से कनेक्ट करें.

4

Use Case कॉन्फ़िगर करें

Use Case का नाम सेट करें (useCaseId). आप upstream blocks से custom metadata भी map कर सकते हैं.

5

Workflow deploy करें

अपने workflow को deploy या update करें. जब भी workflow चलता है, events automatically बनाए जाते हैं.

Workflow block image upload और event creation को एक ही step में संभालता है.

REST API

जो custom integrations या pipelines Workflows का उपयोग नहीं करतीं, उनके लिए आप REST API के माध्यम से सीधे events भेज सकते हैं.

प्रमाणीकरण

सभी write endpoints के लिए एक API key चाहिए जिसमें visionEvents.write या device.update scope हो. API key को Bearer token के रूप में पास करें:

Authorization: Bearer YOUR_API_KEY

End-to-End उदाहरण: Image अपलोड करें + Event बनाएं

Events भेजने से पहले आपको एक Use Case बनाना होगा. किसी useCaseId का संदर्भ देने वाले events जो मौजूद नहीं है, अस्वीकार कर दिए जाएंगे.

API के माध्यम से events भेजते समय, पहले image upload करें, फिर uploaded image का संदर्भ देते हुए event बनाएं.

Step 1: image अपलोड करें

curl -X POST "https://api.roboflow.com/vision-events/upload" \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -F "file=@inspection_photo.jpg"

Response:

{
  "success": true,
  "sourceId": "abc123def456",
  "url": "https://storage.googleapis.com/your-workspace/abc123def456/original.jpg"
}

Step 2: event बनाएं, uploaded image का संदर्भ देते हुए

curl -X POST "https://api.roboflow.com/vision-events" \\
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -d '{
    "eventType": "quality_check",
    "useCaseId": "assembly-line-qa",
    "timestamp": "2026-03-30T14:30:00.000Z",
    "deviceId": "factory-cam-01",
    "streamId": "line-3",
    "images": [
      {
        "sourceId": "abc123def456",
        "objectDetections": [
          {
            "class": "defect",
            "x": 320,
            "y": 240,
            "width": 50,
            "height": 40,
            "confidence": 0.95
          }
        ]
      }
    ],
    "eventData": {
      "result": "fail"
    },
    "customMetadata": {
      "line_id": "line-3",
      "shift": "morning",
      "part_number": "PN-4421"
    }
  }'

Response:

{
  "eventId": "evt-789ghi",
  "created": true
}

Batch में Events बनाएं

batch endpoint का उपयोग करके एक ही request में अधिकतम 100 events भेजें:

curl -X POST "https://api.roboflow.com/vision-events/batch" \\
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -d '{
    "events": [
      {
        "eventType": "quality_check",
        "useCaseId": "assembly-line-qa",
        "eventData": { "result": "pass" },
        "customMetadata": { "line_id": "line-1" }
      },
      {
        "eventType": "quality_check",
        "useCaseId": "assembly-line-qa",
        "eventData": { "result": "fail" },
        "customMetadata": { "line_id": "line-2" }
      }
    ]
  }'

प्रति batch request अधिकतम 100 events.

Edge Device Backup

ऐसे enterprise deployments के लिए जहाँ connectivity बीच-बीच में बाधित हो सकती है, edge device events को स्थानीय रूप से संग्रहीत करता है और connectivity बहाल होने पर उन्हें Roboflow के साथ sync करता है.

Edge Device Backup के लिए Deployment Manager आवश्यक है. सेटअप निर्देशों के लिए Deployment Manager documentation देखें.

Vision Events backup सक्षम करने के लिए:

1. खोलें Deployment Manager अपने workspace में

2. कॉन्फ़िगर करने के लिए device चुनें

3. सक्षम करें Vision Events Backup device की Event Store configuration में

4. Events device पर local event store में लिखे जाते हैं

5. जब device फिर से कनेक्ट होता है, events अपने आप Roboflow के साथ sync हो जाते हैं

Sync पूरा होने के बाद events Vision Events dashboard में दिखाई देते हैं.