Documentation for C-Werk 2.0.
Previous page
Next page
On page:
Get frame by timestamp
GET http://IP-Address:port/prefix/archive/media/{VIDEOSOURCEID}/{STARTTIME} – gets frame by its STARTTIME. Frame is returned in JPEG format.
- {VIDEOSOURCEID} – three-component source endpoint ID (see Get list of video cameras and information about them). For instance, "Server1/DeviceIpint.3/SourceEndpoint.video:0:0".
- {STARTTIME} − time in ISO format. Set the timezone to UTC+0.
| Parameter | Required | Description |
|---|---|---|
| threshold | No | If there is no frame at a given time, then the first frame from the [STARTTIME; STARTTIME + threshold] range is returned, where threshold is specified in milliseconds. If there is no frame in the specified range, then there will be a 404 Not Found error in the response. |
w h | No | w – frame width, h – frame height. Note If h and w values are more than size of original frame, the frame will be received with original size. Zooming out of width and height is available only discretely − in 2, 4, 8 times, etc. If specified sizes are not corresponding to 1/2, 1/4 etc. of original frame size, the frame will be received with size divisible by the original frame size close to specified values. |
left top right bottom | No | left – horizontal indent from the upper left corner. Possible values are 0 to 1. The default is 0. top – vertical indent from the upper left corner. Possible values are 0 to 1. The default is 0. right – the ratio of the original image width. Possible values are 0 to 1. The default is 1. bottom – the ratio of the original image hight. Possible values are 0 to 1. The default is 1. |
Sample request: 1:
GET http://127.0.0.1:80/archive/media/SERVER1/DeviceIpint.1/SourceEndpoint.video:0:0/20210910T092100
Query result:
Sample request: 2:
GET http://127.0.0.1:80/archive/media/SERVER1/DeviceIpint.1/SourceEndpoint.video:0:0/20210910T092200?archive=hosts/SERVER1/MultimediaStorage.AntiqueWhite/MultimediaStorage
Query result:
Get frame registration time
GET http://IP-Address:port/prefix/archive/contents/frames/{VIDEOSOURCEID}/{ENDTIME}/{BEGINTIME} – getting the time of frames registration in the archive.
Note
The ENDTIME and BEGINTIME syntax is described in Get archive contents section.
| Parameter | Required | Description |
|---|---|---|
| limit | No | The default value of limit parameter is 250. This parameter is optional for Server and it can return fewer search results. |
Sample request:
GET http://127.0.0.1:80/archive/contents/frames/Server1/DeviceIpint.2/SourceEndpoint.video:0:0/past/future?limit=3
Sample response:
{
"frames": [
"20200525T113229.649000",
"20200525T113229.100000",
"20200525T113228.588000"
],
"more": true
}
| Parameter | Description |
|---|---|
| frames | An array containing the timestamps of the stored frames. Note Time is returned in the UTC format. |
| more | true − the Server returned all frames from the specified range. false − the Server did not return all frames because the limit was exceeded (limit parameter). |
Overview
Content Tools