Zubie Zinc

Appearance

🚬 Smoke Detection ​

Zubie's smoke detection alerts you when smoke or vapor is detected inside a vehicle. The system provides detailed reports on each event, including the strength of particulates detected.

NOTE Smoke detected events mentioned in this article refer only to events identified by Zubie's smoke detection devices, not events triggered by dashcam detection.

🔎 Use Cases For Smoke Detection ​

🚭 Enforce No-Smoking Policies: Get objective, timestamped evidence of smoking to enforce policies, issue fines, or restrict future rentals.

💰 Cost Recovery: Justify cleaning or damage fees with concrete proof of smoking, protecting you against disputes and documenting incidents for insurance claims.

🧼 Maintain Vehicle Cleanliness: Automate alerts to your service team to ensure vehicles are cleaned promptly, maintaining high customer satisfaction and brand reputation.

🚨 Retrieving events ​

You can retrieve smoke detection events in two ways:

  1. Webhooks (Recommended): Receive real-time event notifications by enabling the vehicle_smoke_detected webhook. This is the preferred method for continuous monitoring for speed and resource efficiency. See our Webhooks Guide for setup instructions.

  2. Events API: Poll the API for historical events. This is best for on-demand lookups or retrieving the details for a single event.

  • A list of historical smoke detection events can be retrieved using the events?event=vehicle_smoke_detected API endpoint.
  • Specific events can be retrieved using the /event/{event_key} API endpoint.
IMPORTANT The events API should only be used to access on-demand historical events or the details of a single event. For real-time/continuous alerts, always use webhooks.

🎬 Accessing Event Media ​

🔑 Get The Event Media Key ​

A media key is required to call the smoking event media API endpoint. To obtain the media key, call the /event/{event_key} API endpoint using the event key property provided in the vehicle_smoke_detected webhook.

Both the /event/{event_key} and the /events API endpoints will include a media: [] property which is an array of media objects.

json
"media": [
    {
        "key": "agpzfnf1YmllY2FyciELEgVNZWRpYSIWaHFZRlZtc3o1YUJ3RHlieXFmdm9Tbgw",
        "labels": ["event:smoke-detected"],
        "media_type": "application/pdf",
        "status": "ready"
    },
],

Extract the media key from the media object.

📷 Call The Event Media API Endpoint ​


IMPORTANT To retrieve event media, the media.read scope must be added to the Zinc app. This must be approved by Zubie. You can request access by emailing support@zubie.com.

Once the media key has been obtained, a call can be made to the /media/{media_key}/fetch API endpoint, which will return a temporary, signed URL that contains the corresponding event media.

GET

http
https://api.zubiecar.com/api/v2/zinc/media/{media_key}/fetch

More information on the /media API endpoint can be found at https://developer.zubie.com/reference/media.

📄 Sample Media ​

A sample report can be downloaded here.