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://demo.networkoptix.com: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://demo.networkoptix.com: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://demo.networkoptix.com:7001/ec2/recordedTimePeriods?cameraId=5bafc0e9-56be-97f8-5034-45a50cecf3d8