GetVideoList-Documentation

Applicable Products

Cloud VoD

API Description

Call the getVideoList client to get a list of uploaded videos (including: upload time, video name, video ID, video status, etc.)

API URL: https://api.cdnetworks.com/vod/videoManage/getVideoList
Method: POST,GET

Call frequency

Single user trigger frequency: 300/5min

The API Explorer provides the ability of visual interface online call API, code examples generation, and API documents quickly search .Try it

Request parameter(s)

Body Params

Name	Description
createUserString	Create a user. The value is blank by default. Multiple entries are allowed. They are separated by commas (,) and cannot start or end with a comma. This parameter is restricted by permissions. Only sub-accounts or users with special permissions can be queried.
startTimeString	The start time is in the format of 2016-01-01 12:00:00. Query videos by creation time range.
endTimeString	The query end time is in the format of 2016-01-01 12:00:00. This parameter is used to query videos in the creation period, which is smaller than the current query time.
videoNameString	Video name, used to filter videos, support fuzzy matching;
videoIdString	Video ID, used to filter videos;
videoStatusInteger	Video status, used to filter videos
transcodeStateInteger	Authorized play is not enabled. Procedure
videoClassificationString	Separate video categories with commas (,).
listOrderInteger	List order
pageIndexInteger	Page of the video list. The value starts from 1. The default value is 1. The product of pageIndex and pageSize must be less than 100000.
pageSizeInteger	Average number of videos per page. The value ranges from 1 to 50. The default value is 10. The product of pageIndex and pageSize must be less than 100000.

Response parameter(s)

Body Params

Name	Description
codeInteger	200 success
messageString	Successful operation
- dataData	Return data
videoTotalInteger	The number of records of the video list information currently returned. Note that the number of records returned here is only the number of records of the current page.
- videoListInfoList	videoListInfo
videoNameString	videoName
videoIdString	videoId
createUserString	createUser
encryptInteger	Whether to encrypt transcoding files. Value range: 0(unencrypted) 1(encrypted)
videoSizeString	The space occupied by the video, and the total space used by the video and its transcoding
videoDurationString	videoDuration
createTimeString	createTime
uploadTimeString	uploadTime
updateTimeString	updateTime
videoDescriptionString	videoDescription
videoClassificationString	videoClassification
imageUrlString	imageUrl
publishDomainString	publishDomain
playerNameString	playerName
playerIdString	playerId
videoStateInteger	Video state Value range: 0(enable) 1(mask)
transcodeStateInteger	If authorized play is not enabled, the video transcoding status ranges from: 1(transcoded) 2(no transcoding) 3(in transcoding) 4(Transcoding fails) Value range of transcoding status when the Authorized Play (video encryption) function is enabled: 1(encrypted transcoding) 2(non-encrypted transcoding) 3(in transcoding) 4(Transcoding fails) 5(not transcoded)
videoSourceCodeInteger	Video source Value range: 0(other) 1(Upload) 2 (Live streaming to recording) 3 (Video pull) 4 (Video cutting) 5 (Video Stitching) 6 (edge pull recording) 10 (universal version of live broadcasting to recording) 11 (Uploading SDK) 12 (Upload tool)
- videoResolutionsList	Video resolution and other information
clarityInteger	Clarity. Value range: 1(original painting) 2(fluency) 3(standard definition) 4(HD) 5(Super clear) -99(record file)
serverTypeInteger	Terminal type. Value range: -1(Source video) 0(PC) 1(mobile terminal)
heightInteger	height
widthInteger	width
fileSizeLong	fileSize

Error code

Error code(code)	Description(message)	HTTP status	Semantic
1512	The start time is incorrect. Enter the following format: YYYY-MM-DD HH:mm:ss	200	The start time is incorrect. Enter the following format: YYYY-MM-DD HH:mm:ss
1513	The end time is incorrect. Enter the following format: YYYY-MM-DD HH:mm:ss	200	The end time is incorrect. Enter the following format: YYYY-MM-DD HH:mm:ss
1519	Ensure that the start time is less than the end time	200	Ensure that the start time is less than the end time
1518	The video input contains special characters	200	The video input contains special characters
1504	videoId contains special characters	200	videoId contains special characters
1515	videoStatus can only enter 0 or 1	200	videoStatus can only enter 0 or 1
1516	transcodeState The value can be an integer ranging from 1 to 5	200	transcodeState The value can be an integer ranging from 1 to 5
1517	videoClassification can only contain Chinese, English, letters, and commas	200	videoClassification can only contain Chinese, English, letters, and commas
1320	The listOrder can only be 0 or 1	200	The listOrder can only be 0 or 1
1321	The listOrder cannot be empty	200	The listOrder cannot be empty
1322	pageIndex can only be an integer greater than 0	200	pageIndex can only be an integer greater than 0
1323	pageSize can only be integers from 1 to 50	200	pageSize can only be integers from 1 to 50
1324	The pageIndex value is too large	200	The pageIndex value is too large

Example

JSON

Request example Copy Copy success#!/bin/bash username='example_username' apiKey='example_apiKey' date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://api.cdnetworks.com/vod/videoManage/getVideoList" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "x-cnc-auth-method: BASIC" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "createUser":"testUser", "startTime":"2016-01-01 12:00:00", "endTime":"2016-01-01 12:00:00", "videoName":"fileName", "videoId":"aaaaabbbbbccccc", "videoStatus":"0", "transcodeState":"1", "videoClassification":"videoClassification1,videoClassification2", "listOrder":"1", "pageIndex":"1", "pageSize":"10" }'

#!/bin/bash
username='example_username'
apiKey='example_apiKey'
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://api.cdnetworks.com/vod/videoManage/getVideoList" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "x-cnc-auth-method: BASIC" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
	"createUser":"testUser",
	"startTime":"2016-01-01 12:00:00",
	"endTime":"2016-01-01 12:00:00",
	"videoName":"fileName",
	"videoId":"aaaaabbbbbccccc",
	"videoStatus":"0",
	"transcodeState":"1",
	"videoClassification":"videoClassification1,videoClassification2",
	"listOrder":"1",
	"pageIndex":"1",
	"pageSize":"10"
}'

Response example Copy Copy success{ "code": 200, "data": { "videoListInfo": [ { "createUser": "testUser", "encrypt": 0, "playerId": "DF2DAF233DDA", "playerName": "基础播放器", "imageUrl": "http://ovptest.haplat.net//live/201708/4101630234a74ee8864e56ea88e5d290_20170801171220/cloudv-cover/9B0F7BA8BCB9D056D4C24ADDBF821D10.jpg", "publishDomain": "ovptest.haplat.net", "transcodeState": "5", "updateTime": "1501578874", "uploadTime": "1501578866", "videoClassification": "无", "videoDescription": "", "videoDuration": "36", "videoId": "9B0F7BA8BCB9D056D4C24ADDBF821D10", "videoName": "creattest_20170801171220", "videoResolutions": [ { "clarity": -99, "fileSize": 5579209, "height": 768, "serverType": -1, "width": 1364 }, { "clarity": 1, "fileSize": 5573951, "height": 768, "serverType": -1, "width": 1364 } ], "videoSize": "11153160", "videoSourceCode": 2, "videoState": "0" }, { "createUser": "testUser", "encrypt": 0, "flashAutoPlay": 1, "flashImageRatio": 0, "flashPlayerId": "DF2DAF233DDA", "flashPlayerName": "基础播放器", "imageUrl": "http://ovptest.haplat.net//live/201708/4101630234a74ee8864e56ea88e5d290_20170801171104/cloudv-cover/E869FC95F3C7493ED56E8751C4AA7BEE.jpg", "publishDomain": "ovptest.haplat.net", "transcodeState": "5", "updateTime": "1501578796", "uploadTime": "1501578790", "videoClassification": "无", "videoDescription": "", "videoDuration": "15", "videoId": "E869FC95F3C7493ED56E8751C4AA7BEE", "videoName": "creattest_20170801171104", "videoResolutions": [ { "clarity": -99, "fileSize": 2533394, "height": 768, "serverType": -1, "width": 1364 }, { "clarity": 1, "fileSize": 2531523, "height": 768, "serverType": -1, "width": 1364 } ], "videoSize": "5064917", "videoSourceCode": 2, "videoState": "0" } ], "videoTotal": 2 }, "message": "操作成功" }

{
    "code": 200,
    "data": {
        "videoListInfo": [
            {
                "createUser": "testUser",
                "encrypt": 0,
                "playerId": "DF2DAF233DDA",
                "playerName": "基础播放器",
                "imageUrl": "http://ovptest.haplat.net//live/201708/4101630234a74ee8864e56ea88e5d290_20170801171220/cloudv-cover/9B0F7BA8BCB9D056D4C24ADDBF821D10.jpg",
                "publishDomain": "ovptest.haplat.net",
                "transcodeState": "5",
                "updateTime": "1501578874",
                "uploadTime": "1501578866",
                "videoClassification": "无",
                "videoDescription": "",
                "videoDuration": "36",
                "videoId": "9B0F7BA8BCB9D056D4C24ADDBF821D10",
                "videoName": "creattest_20170801171220",
                "videoResolutions": [
                    {
                        "clarity": -99,
                        "fileSize": 5579209,
                        "height": 768,
                        "serverType": -1,
                        "width": 1364
                    },
                    {
                        "clarity": 1,
                        "fileSize": 5573951,
                        "height": 768,
                        "serverType": -1,
                        "width": 1364
                    }
                ],
                "videoSize": "11153160",
                "videoSourceCode": 2,
                "videoState": "0"
            },
            {
                "createUser": "testUser",
                "encrypt": 0,
                "flashAutoPlay": 1,
                "flashImageRatio": 0,
                "flashPlayerId": "DF2DAF233DDA",
                "flashPlayerName": "基础播放器",
                "imageUrl": "http://ovptest.haplat.net//live/201708/4101630234a74ee8864e56ea88e5d290_20170801171104/cloudv-cover/E869FC95F3C7493ED56E8751C4AA7BEE.jpg",
                "publishDomain": "ovptest.haplat.net",
                "transcodeState": "5",
                "updateTime": "1501578796",
                "uploadTime": "1501578790",
                "videoClassification": "无",
                "videoDescription": "",
                "videoDuration": "15",
                "videoId": "E869FC95F3C7493ED56E8751C4AA7BEE",
                "videoName": "creattest_20170801171104",
                "videoResolutions": [
                    {
                        "clarity": -99,
                        "fileSize": 2533394,
                        "height": 768,
                        "serverType": -1,
                        "width": 1364
                    },
                    {
                        "clarity": 1,
                        "fileSize": 2531523,
                        "height": 768,
                        "serverType": -1,
                        "width": 1364
                    }
                ],
                "videoSize": "5064917",
                "videoSourceCode": 2,
                "videoState": "0"
            }
        ],
        "videoTotal": 2
    },
    "message": "操作成功"
}

Is the content of this document helpful to you?

Yes

I have suggestion

GetVideoList

Applicable Products

API Description

Call frequency

Request parameter(s)

Body Params

Response parameter(s)

Body Params

Error code

Example

Directory