Requested Media Failed

The REQUESTED_MEDIA_FAILED event notifies subscribers that a requested video clip could not be fetched from the camera’s SD card or could not be processed successfully.

**Event Name:**REQUESTED_MEDIA_FAILED

**Enablement Package:**NA


Trigger Condition

  • REQUESTED_MEDIA_FAILED webhook event should be subscribed.
  • This webhook event is triggered when a user requests a video from camera vendor 15(Surfsight), but the system is unable to process the request.
  • The event is triggered when the request status is 0, indicating failure.

Example Payload

{
  "messageType": "REQUESTED_MEDIA_FAILED",
  "generatedAt": 1733336734676,
  "data": {
    "requestedMediaId": "af4ebe1d-b26c-11ef-8638-9fb0cc96b1ba",
    "requestedMediaName": "02Dec2024_Bat mobile_Request:1",
    "safetyCamDeviceId": "eb13bad6-5ac1-11ed-b541-eddbf2b4723d",
    "safetyCamSerialNum": "357660102526084",
    "startTime": "2024-12-01 19:30:00",
    "endTime": "2024-12-01 19:35:00",
    "requestorId": "03840664-4a03-11e6-98cb-7b86271dc116",
    "requestorName": "Alan Niesel",
    "vehicleId": "df0b96f5-5ac1-11ed-b541-7901fa508824",
    "vehicleName": "Bat mobile",
    "groupId": "c337220c-8672-11e2-9b71-55cae3166848",
    "groupName": "Default Group",
    "driverId": null,
    "driverName": "",
    "customerId": 1059,
    "vendorId": 15,
    "recordStatus": 1,
    "chunksAvailable": [],
    "status": 0,
    "mediaLinks": []
  }
}

Reference

Field

Description

messageType*
string

Type of Message.
Example: REQUESTED_MEDIA_FAILED

generatedAt*
number (epoch ms)

The exact time the webhook was created, in epoch milliseconds (UTC).
Example: 1733336734676

data*
object

Contains all the details related to the media request.

requestedMediaId*
string

A unique identifier for the specific video request. Example: af4ebe1d-b26c-11ef-8638-9fb0cc96b1ba

requestedMediaName*
string

A readable name for the requested video. Usually includes date/time.
Example: 02Dec2024_Bat mobile_Request:1

safetyCamDeviceId*
string

Internal Azuga ID for the camera device. Example: eb13bad6-5ac1-11ed-b541-eddbf2b4723d

safetyCamSerialNum*
String

The serial number printed on the camera device. Example: "357660102526084"

startTime*
string (UTC)

Start timestamp of the requested footage(UTC – format: YYYY-MM-DD HH:MM:SS). Example: 2024-12-01 19:30:00

endTime*
string (UTC)

End timestamp of the requested footage(UTC – format: YYYY-MM-DD HH:MM:SS). Example: 2024-12-01 19:35:00

requestorId*
String

User ID of the person who initiated the request. Example: "03840664-4a03-11e6-98cb-7b86271dc116"

requestorName*
String

Name of the person who initiated the request.
Example: "Alan Niesel"

vehicleId*
string

The Azuga ID of the vehicle from which the footage was requested. Example: df0b96f5-5ac1-11ed-b541-7901fa508824

vehicleName*
string

Display name / fleet number of the vehicle.
Example: Bat mobile

groupId*
string

ID of the group the vehicle belongs to.
Example: c337220c-8672-11e2-9b71-55cae3166848

groupName*
string

Name of the group the vehicle belongs to. Example: Default Group

driverId*
string

ID of the driver linked to the vehicle at the time of the event. Example: null

driverName*
String

Driver name associated at the time of event. Example: "Event Driver"

customerId*
number

Unique ID of the customer account. Example: "1059"

vendorId*
number

Camera vendor ID. Example: 15 (15 - Surfsight camera).

recordStatus*
number

Indicates record availability status.
Example: 1

status*
number

Status of the event.
Example: 0 (Always 0 for failure)