API Tip: Video Footage Export

Nx Media Server allows users to export video using HTTP-GET methods. 

In API documentation one can find section called "Direct download" which describes a way to download certain piece of the archive. 

Note! The archive piece must exist. I.e. if there's no recording for that time you won't get anything.

Fragment of a camera archive to download is identified by camera id, its start time position and duration. Fragment can be downloaded in mpeg-2/ts (.ts) or Matroska (.mkv) format. No transcoding is performed. 

The url to request is:

http://<server_ip>:<port>/hls/<camera_id>.mkv?pos="YYYY-MM-DDTHH:MM:SS"&duration=<seconds>

Note! Here's a link to guide to find camera id.

Example of url:

http://192.168.178.10:7001/hls/5bafc0e9-56be-97f8-5034-45a50cecf3d8.mkv?pos="2017-07-13T00:00:00"&duration=100

Note! Fragment piece date and time should be specified according to Media Server Local Time.

"pos" parameter can also take a string containing time in milliseconds since epoch(Unix time). 

http://192.168.178.10:7001/hls/5bafc0e9-56be-97f8-5034-45a50cecf3d8.mkv?pos="1499904000000"&duration=100

P.S. One can get list of all existing archive pieces for certain camera with request(identified by duration and start position):

http://<server_ip>:<port>/ec2/recordedTimePeriods?cameraId=<camera_id>

Example:

http://192.168.178.10:7001/ec2/recordedTimePeriods?cameraId=5bafc0e9-56be-97f8-5034-45a50cecf3d8

Questions

If you have any questions related to this topic or you want to share your experience with other community members or our team, please visit and engage in our support community or reach out to your local reseller.