Export from archive:
POST http://IP address:port/prefix/export/archive/{VIDEOSOURCEID}/{BEGINTIME}/{ENDTIME}
Export of live video:
POST http://IP address:port/prefix/export/live/{VIDEOSOURCEID}/{BEGINTIME}/{ENDTIME}
|
| Parameter | Required | Description |
|---|---|---|
| waittimeout | No | Wait timeout in milliseconds required for a frame to arrive. The default value is 10000. If the parameter value is less than the reference frame interval, export isn't performed. We recommend specifying the value to at least 30000 |
| archive | No | Name of the archive in the hosts/SERVER1/MultimediaStorage.AliceBlue/MultimediaStorage format (see Get archive contents). If you don't specify the value, the default archive is used for export |
Example of a request:
POST http://127.0.0.1:80/export/archive/Server1/DeviceIpint.1/SourceEndpoint.video:0:0/20200415T085456/20200415T085501?waittimeout=30000
Example of a request body:
{
"format": "mp4",
"vc": 4,
"comment": "сomment"
} |
The supported parameters that are sent in the body of the initial POST request:
| Parameter | Format | Description | Example | |
|---|---|---|---|---|
| format | Text value | Mandatory parameter. It sets the format of the output export container. Acceptable values are:
| "format": "mp4" | |
maxfilesize | Numeric value | Maximum size of an export file in bytes. A new file is created when the size limit is exceeded. Export results in the collection of files. The default value is 0 (as a result, a single file) | "maxfilesize": 1e+6"maxfilesize": 1000000 | |
| vc, ac | Numeric value | Quality of a compression level for video and audio, respectively. Acceptable values are from 0 to 6 (6 is the worst). The default value is 0 | "vc": 3 | |
| freq | Numeric value | Frame rate of the output stream. Default value is 0. Acceptable values are:
| ||
| tsformat | Text value | A template of a time stamp format. Any string can be generated on the basis of http://www.boost.org/doc/libs/1_55_0/doc/html/date_time/date_time_io.html. The default value is %Y-%b-%d %H:%M:%S
| "tsformat": "%B %Y", | |
| croparea | Area | An area of a frame for export. The default value is [[0, 0], [1,1]] (entire frame) Example of an image:
|
| |
| maskspace | Area | An area of a frame for masking, set in coordinates. By default, a frame isn't masked. An area is specified by at least three anchor points + one terminal point (coincides with one of the anchor points). The reference point is the upper left corner. You can specify several areas. Example of an image:
|
| |
| color | Text value | Text color of a comment and a time stamp. It is set in the #FFFFFF web format | "color": "#e31e1e", | |
| comment | Text value | A comment | "comment": "сomment" | |
| Parameters relevant for PDF export only | ||||
| snapshotplace | Area | Location of a frame on the page | ||
| commentplace | Area | Location of a comment on the page | ||
| tsplace | Area | Location of a time stamp on the page | ||
| layout | Numeric value | Page layout. Available values are
| ||
Example of a response:
HTTP/1.1 202 Accepted Connection: Close Location: /export/3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3 Cache-Control: no-cache |
Possible errors:
| Error code | Description |
|---|---|
| 400 | Incorrect request |
| 500 | Server internal error |
GET http://IP address:port/export/{id}/status
id is the value from the Location field (in this case, 3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3). |
Example of a request:
GET http://127.0.0.1:80/export/3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3/status
Example of a response:
{
"id": "38e3e286-c07c-490f-a452-e4b541b958c4",
"state": 2,
"progress": 1.000000000e+00,
"error": "",
"files": [
"Server1_DeviceIpint.10[20190903T050000-20190903T050100].mp4"
],
"filesFriendly": [
"Server1_10.RHCP[20190903T050000-20190903T050100].mp4"
]
} |
| Parameter | Description |
|---|---|
| state | Current state of export. Available values are:
|
| progress | Progress of export session in the range from 0 to 1 |
| error | Description of error, if any |
| files | List of files created as the result of the export |
GET http://IP address:port/prefix/export/{id}/file
id is the value from the Location field (in this case, 3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3). |
| Parameter | Required | Description |
|---|---|---|
| name | Yes | Name of a file from the files field |
Example of a request:
GET http://127.0.0.1:80/export/3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3/file?name=Server1_DeviceIpint.10[20190903T050000-20190903T050100].mp4
On the server, the exported file is saved to the C:\ProgramData\AxxonSoft\AxxonOne\Export\{ID} folder. |
Deletion of a created file on the server:
DELETE http://IP address:port/prefix/export/{id}
|
Example of a request:
DELETE http://127.0.0.1:80/export/3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3
