Webhooks
SupportAPI Feedback
Start typing to search…

Requested Media Submitted

The REQUESTED_MEDIA_SUBMITTED event is triggered when a user submits a request to retrieve a video clip from a camera. This event confirms that the system has received the request successfully and has started processing it. At this stage, no video chunks or media links are available yet the system has only logged the request.

**Event Name:**REQUESTED_MEDIA_SUBMITTED

**Enablement Package:**NA

Trigger Condition

  • REQUESTED_MEDIA_SUBMITTED webhook event should be subscribed.
  • The webhook is triggered when a user requests a video from a Surfsight (vendor 15) camera, except when the request is made by a Fleet-Pro Integration User.
  • The event is triggered when the request status is 1, indicates submitted.

Example Payload

{
  "messageType": "REQUESTED_MEDIA_SUBMITTED",
  "generatedAt": 1732639083923,
  "data": {
    "requestedMediaId": "573d40d4-ac14-11ef-b0b8-230c90d6e1c2",
    "requestedMediaName": "25Nov2024_0101303489_Request:2",
    "safetyCamDeviceId": "1457c06c-0533-11ee-b8c4-ad3118588c1b",
    "safetyCamSerialNum": "357660102175957",
    "startTime": "2024-11-24 18:30:00",
    "endTime": "2024-11-24 18:30:30",
    "requestorId": "03840664-4a03-11e6-98cb-7b86271dc116",
    "requestorName": "Alan Niesel",
    "vehicleId": "ddb312c8-3063-11ee-924d-9f6b04f645e8",
    "vehicleName": "0101303489",
    "groupId": "c337220c-8672-11e2-9b71-55cae3166848",
    "groupName": "Default Group",
    "driverId": "8a94907b-918c-6f64-0191-927652f42c68",
    "driverName": "Event Driver",
    "customerId": 1059,
    "vendorId": 15,
    "recordStatus": 1,
    "chunksAvailable": [],
    "status": 1,
    "mediaLinks": []
  }
}

Reference

Field

Description

messageType*
string

Type of Message(dentifies the type of event being sent).
Example: REQUESTED_MEDIA_SUBMITTED

generatedAt*
number (epoch ms)

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

data*
object

Contains all the details related to the media request.

requestedMediaId*
string

A unique identifier for the specific video request. Example: 573d40d4-ac14-11ef-b0b8-230c90d6e1c2

requestedMediaName*
string

A readable name for the requested video. Usually includes date/time.
Example: 25Nov2024_0101303489_Request:2

safetyCamDeviceId*
string

Internal Azuga ID for the camera device. Example: 1457c06c-0533-11ee-b8c4-ad3118588c1b

safetyCamSerialNum*
String

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

startTime*
string (UTC)

Start timestamp of the requested footage (UTC – format: YYYY-MM-DD HH:MM:SS). Example: 2024-11-24 18:30:00

endTime*
string (UTC)

End timestamp of the requested footage (UTC – format: YYYY-MM-DD HH:MM:SS). Example: 2025-01-01 18:30:30

requestorId*
String

Unique ID of the user who requested the video. 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: ddb312c8-3063-11ee-924d-9f6b04f645e8

vehicleName*
string

Display name / fleet number of the vehicle.
Example: 0101303489

groupId*
string

ID of the group the vehicle belongs to.
Example: 8a94907b-918c-6f64-0191-927652f42c68

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: 8a94907b-918c-6f64-0191-927652f42c68

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 (15 = Surfsight camera).

recordStatus*
number

Indicates record availability status.
Example: 1

chunksAvailable*
array

List of all available video segments (chunks) from each camera stream.

mediaLinks*
array

Download links for the video files and thumbnails.

status*
number

Type of media. Example: 1 (1 = Submitted)

Updated 4 days ago