服务端 API 与回调常见问题

更新时间:
复制 MD 格式

本文介绍调用视频点播服务端 API 及配置事件回调时的常见问题。

如何为不同环境(生产/测试)配置不同的回调地址?

控制台仅支持配置一个全局回调地址。如需为第二套环境指定回调,可在调用 API(如 SubmitAIMediaAuditJob、SubmitTranscodeJobs)时,通过 UserData 参数中的 MessageCallback.CallbackURL 指定回调地址,该配置仅对当次任务生效,不影响全局回调。

配置回调后服务器收不到回调通知?

  • 回调接口若存在 301/302 重定向会导致回调失败,请去掉重定向后重试。

  • 回调地址需在收到请求后返回 HTTP 200。

  • 回调域名需公网可解析(建议使用全球可解析域名),服务器防火墙需放行阿里云回调请求。

调用接口报 TemplateGroupID 不存在?

请确认调用 CreateUploadVideo 等接口时使用的 AccessKey 属于当前账号:TemplateGroupID 与账号绑定,使用其他账号的 AccessKey 调用会提示模板组不存在。

回调中如何获取视频文件名称?

回调消息默认不包含源文件名称。可根据回调返回的 VideoId 调用 GetMezzanineInfo 接口查询源文件信息(含文件名、源文件地址等)。

GetDailyPlayRegionStatis 返回流量与控制台计费流量不一致?

该接口返回流量单位为 Byte,且为应用层统计值;计费流量在此基础上乘以 1.1 的 TCP 网络消耗系数。将接口返回值乘以 1.1 后即可与计费流量对齐。

如何批量删除媒资、批量获取全部 videoId?

  • 批量删除:控制台手动删除,或调用 DeleteVideo 接口(单次最多传 20 个 videoId)循环删除。

  • 批量获取 videoId:使用控制台「导出媒资信息」功能,或调用 SearchMedia 接口分批查询。

如何跨账号迁移媒资内容?

资源包不支持跨账号共用,但媒资内容可迁移:在目标账号使用 URL 批量拉取上传接口拉取源账号的媒资地址完成迁移,封面可通过 CoverURL 参数指定,需要转码时配合 SubmitTranscodeJobs 接口处理。