VideoClipQuery-Documentation

POSTGET

https://api.cdnetworks.com/vod/videoManage/videoClipQuery

Call videoClip to query the clipping result of the clipping task.

Limit of request rate per user: 300/5min
Applicable Products: Cloud VoD

For API authentication details, please refer to: API Authentication Overview

Request

Body Params

Name	Description
*transNoString	Customer video cut task code, up to 32 bits

Response

Body Params

Name	Description
codeInteger	code
messageString	message
- dataObject	data
taskIdString	taskId
transNoString	transNo
statusInteger	state Value range: 1(in process) 2(Successful) 3(Failure)
- videoInfoObject
videoNameString	videoName
videoIdString	videoId
encryptInteger	Whether to encrypt transcoding files Value range: 0(unencrypted) 1(encryption)
videoSizeString	The space occupied by the video, and the total space used by the video and its transcoding
videoDurationString	videoDuration
uploadTimeString	uploadTime
updateTimeString	updateTime
videoDescriptionString	videoDescription
videoClassificationString	videoClassification
imageUrlString	Video cover URL
publishDomainString	publishDomain
playerNameString	playerName
playerIdString	playerId
videoStateInteger	Video state Value range: 0(normal) 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(no transcoding)
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: 0(PC) 1(original video)
heightInteger	height
widthInteger	width
fileSizeLong	fileSize

Error code

Error code(code)	Description(message)	HTTP status	Semantic
1560	The video is being processed	200	The video is being processed
1601	TRANSNO cannot be empty	200	TRANSNO cannot be empty
1602	TRANSNO is not legal	200	TRANSNO is not legal
1603	TRANSNO does not exist	200	TRANSNO does not exist

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/videoClipQuery" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "x-cnc-auth-method: BASIC" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "transNo":"XXXXXXXXXXXXXXXXXXX" }'

#!/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/videoClipQuery" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "x-cnc-auth-method: BASIC" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
	"transNo":"XXXXXXXXXXXXXXXXXXX"
}'

Response example Copy Copy success{ "code": 200, "data": { "status": 2, "taskId": "036b6fb401611000be5f693600000000", "transNo": "036b6f4a01611000a79c3a7800000000", "videoInfo": { "encrypt": 1, "playerId": "DF2DAF233DDA", "playerName": "name", "imageUrl": "http://ovptest.haplat.net/clip/2018-01-17/036b6fb401611000431d330300000000/cloudv-cover/DC543253DFA4D22C9ABF3F76721E54E7.jpg", "publishDomain": "ovptest.haplat.net", "transcodeState": "1", "updateTime": "1516182478", "uploadTime": "1516180828", "videoClassification": "", "videoDescription": "", "videoDuration": "189", "videoId": "DC543253DFA4D22C9ABF3F76721E54E7", "videoName": "3234234", "videoResolutions": [ { "clarity": 1, "fileSize": 14937188, "height": 360, "serverType": -1, "width": 640 }, { "clarity": 2, "fileSize": 9204528, "height": 360, "serverType": 0, "width": 640 }, { "clarity": 3, "fileSize": 15184451, "height": 480, "serverType": 0, "width": 720 } ], "videoSize": "39326167", "videoSourceCode": 4, "videoState": "0" } }, "message": "Operation succeeded" }

{
    "code": 200,
    "data": {
        "status": 2,
        "taskId": "036b6fb401611000be5f693600000000",
        "transNo": "036b6f4a01611000a79c3a7800000000",
        "videoInfo": {
            "encrypt": 1,
            "playerId": "DF2DAF233DDA",
            "playerName": "name",
            "imageUrl": "http://ovptest.haplat.net/clip/2018-01-17/036b6fb401611000431d330300000000/cloudv-cover/DC543253DFA4D22C9ABF3F76721E54E7.jpg",
            "publishDomain": "ovptest.haplat.net",
            "transcodeState": "1",
            "updateTime": "1516182478",
            "uploadTime": "1516180828",
            "videoClassification": "",
            "videoDescription": "",
            "videoDuration": "189",
            "videoId": "DC543253DFA4D22C9ABF3F76721E54E7",
            "videoName": "3234234",
            "videoResolutions": [
                {
                    "clarity": 1,
                    "fileSize": 14937188,
                    "height": 360,
                    "serverType": -1,
                    "width": 640
                },
                {
                    "clarity": 2,
                    "fileSize": 9204528,
                    "height": 360,
                    "serverType": 0,
                    "width": 640
                },
                {
                    "clarity": 3,
                    "fileSize": 15184451,
                    "height": 480,
                    "serverType": 0,
                    "width": 720
                }
            ],
            "videoSize": "39326167",
            "videoSourceCode": 4,
            "videoState": "0"
        }
    },
    "message": "Operation succeeded"
}

Is the content of this document helpful to you?

Yes

I have suggestion

VideoClipQuery

Request

Body Params

Response

Body Params

Error code

Example

Directory