Page History
Description
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 a new video entity
Create the new video entity with the following request:
Request
| Code Block | ||||
|---|---|---|---|---|
| ||||
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/ |
| Note |
|---|
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. |
Response
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.Status colour Green title 201 CREATED
| Code Block | ||||
|---|---|---|---|---|
| ||||
locationLocation: https://vmproapi.movingimagevideo-cdn.comnet/vamv1/rest/vms/<VIDEOMANAGER_ID>/videos/<VIDEO_ID>/source/<REPLACEMENT_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. |