Video regeneration

The video recording (archive) will be created immediately and returned in the response. Subsequently, the partial archive will be downloaded asynchronously.

The download link for the archive will be sent via Websockets push with the type archive_generated

POST /api/admin/v1/downloads/{download}/repeat

Method parameters

int download, unique identifier of the video recording

200 OK

Successful response

JSON

{
    "name": "City, Street 2, file.mp4",
    "type": "mp4",
    "url": "http://127.0.0.1:8080/storage/",
    "from": "2019-09-20 16:13:20",
    "to": "2019-09-20 16:22:27",
    "created_at": "2019-09-20T17:00:00.000000Z",
    "updated_at": "2023-02-10T15:09:25.000000Z",
    "is_file_exists": true,
    "stream": {
        "id": 1,
        "type": "high",
        "camera_id": 1,
        "status": null,
        "url": "rtsp://admin:456redko@192.168.204.13:554/Streaming/Channels/101",
        "bitrate": null,
        "resolution": null,
        "output_rate": null,
        "ip": "192.168.204.13",
        "uuid": "fecb93a5-0c0e-4515-9115-633c45994b29",
        "sound": null,
        "streams_count": null,
        "created_at": "2023-02-03T08:29:06.000000Z",
        "updated_at": "2023-02-03T08:29:06.000000Z",
        "is_preview_from_server": true,
        "is_archive_from_server": null,
        "is_enabled": true,
        "is_can_transfer": true,
        "source": "manual",
        "is_sound_enabled": null,
        "reconnect_attempt": null,
        "reconnect_total": null,
        "reconnect_time": null,
        "disconnections_count": 0,
        "camera": {
            "id": 1,
            "group_id": 2,
            "status": "initial",
            "type": "media_server_v2",
            "start_at": null,
            "created_at": "2023-02-03T08:29:06.000000Z",
            "name": "Camera 1",
            "can_edit": true,
            "origin": null,
            "user_type": "individual",
            "shared_from": null,
            "ip": "192.168.204.13",
            "lat": null,
            "lng": null,
            "azimuth": null,
            "is_sensitive": 0,
            "is_public": 0,
            "is_ip_reserved": false,
            "count_issues": 0,
            "source": "manual",
            "archive_storage_days": null,
            "is_archive_recording": false,
            "archive_recording_type": "fulltime",
            "is_increased_reconnect": 0,
            "is_sound_enabled": true,
            "is_bridge": false,
            "can_change_archive_timetable": true,
            "is_auto_create_streams": false,
            "is_provisioning_enable": false,
            "is_can_manage_archive_storage_days": true,
            "is_editable": true,
            "status_changed_at": null,
            "is_intercom": false,
            "deleted_at": null
        },
        "is_actual": true,
        "condition": "active",
        "stopped_at": ""
    }
}

401 Unauthorized

Authorization token is not provided or is invalid. Obtaining a token

402 Payment Required

License error

422 Unprocessable Entity

Returns a JSON object with an error. Validation

JSON

{
    "message": "There will be no informative message here",
    "errors": {
        "any_key": [
            "The reason for the error will be described here"
        ]
    }
}

cURL

BASH

curl -k --request POST \
	--url 'https://your-domain/api/admin/v1/downloads/{download}/repeat' \
	--header 'Content-Type: application/json' \
	--header 'Accept: application/json' \
	--data '{
    "download": 0
}'

PHP

$data = array (
  'download' => 0,
);
$context = stream_context_create([
	'ssl'=>['verify_peer' => false],
	'http' => [
		'method' => 'POST',
		'header' => "Content-Type: application/json\r
Accept: application/json",
		'content'=>json_encode($data)
	]
]);
$result = file_get_contents('https://your-domain/api/admin/v1/downloads/{download}/repeat', false, $context);