腾讯云点播回调接入说明

本文档说明如何将腾讯云点播（VOD）事件转发到 EventHub，覆盖以下事件类型：

视频上传完成
视频转码完成
视频审核完成
视频播放详情
其他点播事件

1. 接入总览

EventHub 接收腾讯云点播回调的地址为：

项目	值
生产 Base URL	`https://eh.citv.cc`
完整地址	`https://eh.citv.cc/event/tx/vod/{appid}`
请求方法	`POST`
Content-Type	`application/json`

其中：

{appid} 由 EventHub 分配
EventHub 会根据 {appid} 找到对应的应用配置，并使用该应用的 secret 校验签名

2. 回调格式

回调字段

字段名	类型	是否必填	描述
Version	string	是	版本号
EventType	string	是	事件类型
FileId	string	是	文件 ID
eventhub	object	是	事件元数据
...	-	-	腾讯云其他原始字段

eventhub 对象字段说明

字段名	类型	是否必填	描述
ccid	string	是	业务侧内容唯一标识，用于关联业务系统中的内容记录
title	string	否	视频标题
sourceType	string	否	内容来源类型，如 `upload`（上传）、`record`（录制）等

示例

{
  "Version": "2.0",
  "EventType": "transcode",
  "FileId": "5314976718669604713",
  "...": "腾讯云其他原始字段",
  "eventhub": {
    "ccid": "83633_5145403710254666917",
    "title": "产品宣传视频",
    "sourceType": "upload"
  }
}

3. 签名规则

签名算法为：

sign = MD5(secret + t)

说明：

secret 由 EventHub 分配（即回调密钥）
t 是秒级时间戳，表示签名过期时间
sign 需要写在请求的 sign 字段中

4. 注意事项

腾讯云原始回调字段应完整保留在根对象中
eventhub.ccid 用于唯一标识该视频内容，建议使用业务侧的视频 ID
eventhub.title 用于展示视频标题
eventhub.sourceType 用于区分视频来源（上传、录制、迁移等）

腾讯云点播回调

On this page