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. |