Retrieve the link to an event file generated by the device. The URL remains active for approximately several minutes to a few hours. If this call is made shortly after the event, the event media may not be uploaded yet and a 404 error is returned. In this case, try again a few minutes later.
If multiple events are generated with the same timestamp, to the second, and the same media type, the media file from the last request is used for all of them. To have different media files for each virtual event, use timestamps that differ by at least a second.
This API can be used in two ways:
1. For events in a given period of time. The files can then be downloaded. All the information required for this call is available in the event object received from the GET /devices/{imei}/events call
2. For virtual events, without using the GET /devices/{imei}/events call. You need additional information, such as the virtual event configuration on your device and the IDs of the cameras connected to the device
Successful operation
Bad request error
Unauthorized error
Forbidden error
Not found error
Internal server error
curl -i -X GET \ 'https://api-prod.surfsight.net/v2/devices/:imei/event-file-link?fileId=1595077872&fileType=video&cameraId=1&cameraIds=1%2C2%2C51%2C52&conceal=true&eventId=3' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
{
}