To start the upload process, you need to first create a video entity. Creating the entity will allow you to collect the video ID, which you will need to finish uploading your video.
Create the new video entity with the following request:
curl -v -X POST -H "Authorization: Bearer <ACCESS_TOKEN>" -H "Content-Type: application/json" -d "{ 'title': '<VIDEO_TITLE>', 'description': '<DESCRIPTION_OF_VIDEO>', 'keywords': ['<FOO>', '<BAR>'], 'group': <ID_OF_OWNER_GROUP>, 'channel': <ID_OF_CHANNEL>, 'fileName': '<FILENAME>', 'autoPublish': true }" https://api.video-cdn.net/v1/vms/<VIDEOMANAGER_ID>/videos/ |
The use of verbose mode ("-v") in the above request is optional if you already have a way to collect the video ID from the response header. If using a command line tool, it may be necessary to enable verbose mode to allow you to see the response headers. |
Parameters | Data Type | Description |
---|---|---|
VIDEOMANAGER_ID | Integer | mandatory: ID of the VideoManager, to which you intend to upload the video. |
Headers | ||
ACCESS_TOKEN | String | mandatory: Access token (see "Authentication" for more information). |
JSON Body | ||
title | String | optional: Title of the video |
description | String | optional: Description of the video |
keywords | List of Strings | optional: Keywords of the video |
group | Integer | optional: ID of the owner group |
channel | Integer | optional: ID of the channel |
fileName | String | mandatory: Filename of the video (see suffix note below) |
autoPublish | Boolean | optional: If true, the video will automatically be published after upload is complete and the 360p mp4 has been transcoded. |
The location data of the response header will return a URL containing the newly created video ID. You will need this video ID for the next step.
Location: https://api.video-cdn.net/v1/vms/<VIDEOMANAGER_ID>/videos/<VIDEO_ID> |
Parameter | Data Type | Description |
---|---|---|
VIDEOMANAGER_ID | Integer | ID of the VideoManager, in which you intend to upload the video. |
VIDEO_ID | String | Newly created video ID for the new video entity. |