服务端 API 文档

视频上传完成

最近更新时间:2021-04-13 16:08:25

注意:

  • 本文档为3.0版本的格式回调,2.0版本的历史格式回调请参见 历史格式回调 文档。
  • 建议您将回调版本逐步迁移到3.0格式,2.0格式回调的文档将不再维护。

事件名称

NewFileUpload

事件说明

当 App 配置了事件通知,并且将视频通过客户端或服务端上传后,App 后台即可通过“普通回调”或“可靠回调”的方式获取该事件通知。事件通知内容为 FileUploadTask 结构

普通回调3.0

如果选择普通回调模式,则回调 URL 会接收到来自云点播的 HTTP 请求。请求采用 POST 方法,请求内容在 BODY 中,如下所示(省略了值为 null 的字段)。

{
  "EventType":"NewFileUpload",
  "FileUploadEvent":{
      "FileId":"5285890784273533167",
      "MediaBasicInfo":{
          "Name":"动物世界",
          "Description":"",
          "CreateTime":"2019-01-09T16:36:22Z",
          "UpdateTime":"2019-01-09T16:36:24Z",
          "ExpireTime":"9999-12-31T23:59:59Z",
          "ClassId":0,
          "ClassName":"其他",
          "ClassPath":"其他",
          "CoverUrl":"",
          "Type":"mp4",
          "MediaUrl":"http://125676836723.vod2.myqcloud.com/xxx/xxx/q1BORBPQH1IA.mp4",
          "TagSet":[
           ],
          "StorageRegion":"ap-guangzhou-2",
          "SourceInfo":{
              "SourceType":"Upload",
              "SourceContext":""
          },
          "Vid":"5285890784273533167"
      },
      "ProcedureTaskId":""
  }
}

可靠回调3.0

如果选择可靠回调模式,调用 拉取事件通知 API 会接收到如下形式的 HTTP 应答(省略了值为 null 的字段)。

{
"Response": {
"EventSet": [
    {
        "EventHandle": "EventHandle.N",
        "EventType": "NewFileUpload",
        "FileUploadEvent": {
            "FileId": "5285890784273533167",
            "MediaBasicInfo": {
                "Name": "动物世界",
                "Description": "",
                "CreateTime": "2019-01-09T16:36:22Z",
                "UpdateTime": "2019-01-09T16:36:24Z",
                "ExpireTime": "9999-12-31T23:59:59Z",
                "ClassId": 0,
                "ClassName": "其他",
                "ClassPath": "其他",
                "CoverUrl": "",
                "Type": "mp4",
                "MediaUrl": "http://125676836723.vod2.myqcloud.com/xxx/xxx/q1BORBPQH1IA.mp4",
                "TagSet": [],
                "StorageRegion": "ap-guangzhou-2",
                "SourceInfo": {
                    "SourceType": "Upload",
                    "SourceContext": ""
                },
                "Vid": "5285890784273533167"
            },
            "ProcedureTaskId": ""
        }
    }
],
"RequestId": "335bdaa3-db0e-46ce-9946-51941d9cb0f5"
}
}
目录