Webhooks
SupportAPI Feedback
Start typing to search…

Requested Media Available

The REQUESTED_MEDIA_AVAILABLE webhook notifies subscribers when all requested video media from a supported camera has been successfully retrieved from the SD card and is now available in the Azuga system.

**Event Name:**REQUESTED_MEDIA_AVAILABLE

**Enablement Package:**NA

Trigger Condition

  • REQUESTED_MEDIA_AVAILABLE webhook event should be subscribed.
  • The webhook is triggered when the full duration of the requested video stored on the SD card for camera vendor 15 (Surfsight) becomes available in the Azuga system.
  • The event is triggered when the request status is 7, meaning the media is fully available.

Example Payload

{
  "messageType": "REQUESTED_MEDIA_AVAILABLE",
  "generatedAt": 1732610607290,
  "data": {
    "requestedMediaId": "a7475935-abd1-11ef-b0b8-e55bbf945482",
    "requestedMediaName": "26Nov2024_0101303489_Request:2",
    "safetyCamDeviceId": "1457c06c-0533-11ee-b8c4-ad3118588c1b",
    "safetyCamSerialNum": "357660102175957",
    "startTime": "2024-11-26 08:36:16",
    "endTime": "2024-11-26 08:36:46",
    "requestorId": "8a9388a8-84d3-0640-0184-ed783d831309",
    "requestorName": "AFM Admin",
    "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": [
      {
        "cameraId": 2,
        "start": "2024-11-26 08:36:16",
        "end": "2024-11-26 08:36:46"
      },
      {
        "cameraId": 1,
        "start": "2024-11-26 08:36:16",
        "end": "2024-11-26 08:36:46"
      }
    ],
    "status": 7,
    "mediaLinks": [
      {
        "cameraId": 2,
        "start": "2024-11-26 08:36:16",
        "end": "2024-11-26 08:36:46",
        "link": "https://azuga-video-telematics-prod.s3.us-west-2.amazonaws.com/357660102175957/5384790491/1732610191/2.mp4",
        "thumbnailLink": "https://azuga-video-telematics-prod.s3.us-west-2.amazonaws.com/357660102175957/5384790491/1732610191/2.jpg",
        "mediaType": 1
      },
      {
        "cameraId": 1,
        "start": "2024-11-26 08:36:16",
        "end": "2024-11-26 08:36:46",
        "link": "https://azuga-video-telematics-prod.s3.us-west-2.amazonaws.com/357660102175957/5384790494/1732610191/1.mp4",
        "thumbnailLink": "https://azuga-video-telematics-prod.s3.us-west-2.amazonaws.com/357660102175957/5384790494/1732610191/1.jpg",
        "mediaType": 1
      }
    ]
  }
}

Reference

Field

Description

messageType*
string

Type of Message (Identifies the type of event being sent). Example: REQUESTED_MEDIA_AVAILABLE

generatedAt*
Integer (epoch ms)

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

data*
object

Contains all the details related to the media request.

requestedMediaId*
string

Unique ID for the media request. Example: a7475935-abd1-11ef-b0b8-e55bbf945482

requestedMediaName*
string

Name assigned to the request.
Example: 26Nov2024_0101303489_Request:2

safetyCamDeviceId*
string

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

safetyCamSerialNum*
String

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

startTime*
string (UTC)

The start time of the requested video clip(UTC – format: YYYY-MM-DD HH:MM:SS). Example: 2024-11-26 08:36:16

endTime*
string (UTC)

The end time of the requested video clip(UTC – format: YYYY-MM-DD HH:MM:SS). Example: 2024-11-26 08:36:46

requestorId*
String

Unique ID of the user who requested the video. Example: "8a9388a8-84d3-0640-0184-ed783d831309"

requestorName*
String

Name of the person who initiated the request.
Example: "AFM Admin"

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: c337220c-8672-11e2-9b71-55cae3166848

groupName*
string

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

driverId*
string

Driver ID associated at the time of event. Example: 8a94907b-918c-6f64-0191-927652f42c68

driverName*
String

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

customerId*
number

Unique customer identifier. Example: "1059"

vendorId*
number

Camera vendor ID. Example:15 ((15 = Surfsight camera).`

recordStatus*
number

Indicates record availability status.
Example: 1

status*
number

Always 7 for this event. Indicates that full video footage is available.

chunksAvailable*
array

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

mediaLinks*
array

Download links for video and thumbnail per camera stream.

cameraId*
number

ID of the camera stream. Example: (e.g., 1 = road-facing, 2 = driver-facing).

start*
String

Video chunk start time(UTC – YYYY-MM-DD HH:MM:SS). Example: 2024-11-26 08:36:16

end*
string

Video chunk end time(UTC – YYYY-MM-DD HH:MM:SS).
Example: 2024-11-26 08:36:46

link*
string

Direct downloadable video file link(URL). Example: https://azuga-video-telematics-prod.s3.us-west-2.amazonaws.com/357660102175957/5384790491/1732610191/2.mp4"

thumbnailLink*
string

Downloadable image thumbnail(URL). Example: "https://azuga-video-telematics-prod.s3.us-west-2.amazonaws.com/357660102175957/5384790491/1732610191/2.jpg"

mediaType*
number

Type of media. Example: 1 (1 indicates Video)

Updated 5 days ago