UniFi Protect icon

UniFi Protect

Interact with UniFi Protect API
Join our community

Actions18

Overview

This node interacts with the UniFi Protect API to retrieve a thumbnail image from a recorded video at a specific timestamp for a given camera. It is useful for extracting snapshots from surveillance footage, for example, to quickly view a moment of interest without downloading the entire video. Practical applications include security monitoring, incident review, and generating preview images for recorded events.

Use Case Examples

  1. Extract a thumbnail image from a security camera recording at a specific time to review an incident.
  2. Generate preview thumbnails for recorded video clips to display in a dashboard or report.

Properties

Name Meaning
Camera ID The unique identifier (UUID) of the camera from which to get the recording thumbnail.
Timestamp The specific timestamp to extract the frame from the recording.
Additional Options Optional parameters to customize the thumbnail such as width, height, and whether to force generation of the thumbnail.
Request Options Settings for request behavior including batching, SSL certificate validation, proxy configuration, and timeout settings.

Output

JSON

  • thumbnailUrl - URL or data of the retrieved thumbnail image from the recording.

Dependencies

  • Requires an API key credential for UniFi Protect API authentication.

Troubleshooting

  • Ensure the Camera ID is correct and corresponds to an existing camera in the UniFi Protect system.
  • Verify the timestamp is within the range of recorded video for the specified camera.
  • If the thumbnail generation is forced, it may take longer to respond as the system creates a new thumbnail.
  • Check network connectivity and proxy settings if requests fail or time out.
  • If SSL certificate validation fails, consider enabling the option to ignore SSL issues, but be aware of security risks.

Links

Discussion