Page History
Description
To replace a video entity, you will need to first create a new video source.
Once you have created a new video source, you can retrieve the video ID, which is required for uploading the replacement video.
A sample cURL call is shown below.
Request
Code Block | ||||
---|---|---|---|---|
| ||||
curl --location 'https://api.video-cdn.net/v1/vms/<VideoManager_ID>/videos/<VIDEO_ID>/source' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer Token' \ --data '{ "uploadFilename": "fileName.mp4", "file": { "fileName": "fileName.mp4", "size": 7378888 } }' |
Alternatively, you can use the following URL:
Code Block |
---|
https://vmproapi.movingimagevideo-cdn.comnet/vam/restv1/vms/917/<VIDEOMANAGER_ID>/<REPLACEMENTVIDEOvideos/<VIDEO_ID>/source |
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). |
Content-type | Application/json | mandatory: Indicates that the request body format is JSON. |
JSON Body | ||
---|---|---|
uploadFileName | String | Name of the file to be uploaded |
file |
fileName | String | mandatory: Filename of the video (see suffix note below), nested property of file |
size |
String | optional: |
size of the file, nested property of file |
Suffix of the fileName
The suffix of the filename is used to determine the mime type. The following table lists all supported suffixes.
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 | ||||
---|---|---|---|---|
| ||||
location: https://vmpro.movingimage.com/vam/restasset-in.video-cdn.net/chunks/env/prod/vms/<VIDEOMANAGER<VideoManager_ID>/videos/<VIDEO_ID>/source/<REPLACEMENT_VIDEO_ID>?bucketId=<BUCKET_ID>&fileId=<FILE_ID>&userId=<USERID>&__token__=<SECURITY_TOKEN> |
Parameter | Data Type | Description |
---|---|---|
VIDEOMANAGER_ID | Integer | ID of the VideoManager, in which you intend to upload the video. |
VIDEO_ID | String | Video ID of video entity to be replaced REPLACEMENT_VIDEO |
BUCKET_ID | String | Primary bucket ID of video file |
FILE_ID | String | |
File ID of the new | ||
video file | ||
USER_ID | String | ID of user uploading the file |
SECURITY_TOKEN | String | Access token used to access protected resources |