tencent cloud

Video Upload Completion
Download PDF
Last updated: 2025-08-13 16:27:20
Video Upload Completion
Last updated: 2025-08-13 16:27:20
Download PDF

Event Name

NewFileUpload

Event Description

If you have configured event notifications for your application, after a video is uploaded from a client or the server, your application backend will be notified either by a “normal callback” or a “reliable callback”. For the content of the callback, see FileUploadTask.

Normal Callback

In the normal callback mode, your callback URL will receive an HTTP POST request from VOD. The content of the callback is included in the request body, as shown below (fields with null values are omitted):
{
    "EventType":"NewFileUpload",
    "FileUploadEvent":{
        "FileId":"5285890784273533167",
        "MediaBasicInfo":{
            "Name":"Animal World",
            "Description":"",
            "CreateTime":"2019-01-09T16:36:22Z",
            "UpdateTime":"2019-01-09T16:36:24Z",
            "ExpireTime":"9999-12-31T23:59:59Z",
            "ClassId":0,
            "ClassName":"Other",
            "ClassPath":"Other",
            "CoverUrl":"",
            "Type":"mp4",
            "MediaUrl":"http://125676836723.vod2.myqcloud.com/xxx/xxx/q1BORBPQH1IA.mp4",
            "TagSet":[
            ],
            "StorageRegion":"ap-chongqing",
            "SourceInfo":{
                "SourceType":"Upload",
                "SourceContext":""
            },
            "Vid":"5285890784273533167"
        },
        "ProcedureTaskId":"",
        "ReviewAudioVideoTaskId":""
    }
}

Reliable Callback

In the reliable callback mode, after calling the PullEvents API, you will receive an HTTP response in the following format (fields with null values are omitted):
{
    "Response": {
        "EventSet":[
            {
                "EventHandle": "EventHandle.N",
                "EventType": "NewFileUpload",
                "FileUploadEvent":{
                    "FileId": "5285890784273533167",
                    "MediaBasicInfo":{
                        "Name": "Animal World",
                        "Description": "",
                        "CreateTime": "2019-01-09T16:36:22Z",
                        "UpdateTime": "2019-01-09T16:36:24Z",
                        "ExpireTime": "9999-12-31T23:59:59Z",
                        "ClassId": 0,
                        "ClassName": "Other",
                        "ClassPath": "Other",
                        "CoverUrl": "",
                        "Type": "mp4",
                        "MediaUrl": "http://125676836723.vod2.myqcloud.com/xxx/xxx/q1BORBPQH1IA.mp4",
                        "TagSet": [],
                        "StorageRegion": "ap-chongqing",
                        "SourceInfo":{
                            "SourceType": "Upload",
                            "SourceContext": ""
                        },
                        "Vid": "5285890784273533167"
                    },
                    "ProcedureTaskId": "",
                    "ReviewAudioVideoTaskId":""
                }
            }
        ],
        "RequestId": "335bdaa3-db0e-46ce-9946-51941d9cb0f5"
    }
}

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback