字段	类型	是否必填	示例	描述
Action	String	是	SetMessageCallback	公共参数，设置事件通知的回调配置信息，取值：SetMessageCallback
SpaceName	String	否		空间名称，不填则用默认的空间
CallbackSetType	String	否	Global	回调设置类型，取值： Global(全局回调设置) Single(单事件回调设置) 默认为Global
CallbackEventSet	String	否	FetchUploadEvent,VideoTranscodeEvent	开启回调的事件列表，当CallbackSetType为Global时：不传该字段时保持原设置，只做增量更新；传值为空字符串""时关闭所有消息通知；传值为"*"时开启全部消息通知；也可指定开启部分事件的消息通知，多个事件类型使用半角逗号（,）分隔。当CallbackSetType为Single时，则只能传入一个事件类型当前支持的事件类型包括： FetchUploadEvent：拉取上传完成事件 VideoTranscodeEvent：转码完成事件 SnapshotByTimeOffsetEvent：指定时间点截图事件 ImageSpriteEvent：雪碧图事件 SampleSnapshotEvent：采样截图完成事件 VideoMetaEvent：解析视频元信息事件 ProcessingFlowEvent：任务流完成事件 SegmentBodyEvent：人像分割事件
CallbackSecret	String	否	fdsjfpsp	回调鉴权密钥
CallbackType	String	否	http	回调类型，支持类型： http：http回调
CallbackURL	String	否	test.com	回调地址

2. 返回参数

参考公共返回参数

3. API示例

3.1 请求示例

curl -X POST 'https://vod.streamlakeapi.com/?Action=SetMessageCallback' \
-H 'Content-Type: application/json' \
-d '{"CallbackEventSet": "FetchUploadEvent,ProcessingFlowEvent", "CallbackURL": "test.callback.com/test"}'
-H <公共请求参数>

3.2 返回示例

HTTP/1.1 200 OK
Content-Type: application/json
{
    "ResponseMeta": {
        "RequestId": "rB0zK2IQhEgAAAAAAAUWkw",
        "ErrorCode": "",
        "ErrorMessage": ""
    }
}

4. 错误码

ErrorCode	ErrorMessage	说明	状态码
ResourceNotFound	Space does not exist	空间不存在	404
InvalidArgument	failed to set global callback because single callback config with same callback events already exists	无法设置全局回调，因为单一回调有相同的事件类型	400
InvalidArgument	callbackType is invalid, should be http	回调类型不合法，仅支持http	400
InvalidArgument	callbackSetType is invalid, should be global or single	回调事件类型不合法，仅支持Global或者Single	400

上一篇：获取空间列表下一篇：查询消息回调配置

该篇文档内容是否对您有帮助？

有帮助没帮助

关于我们

支持与服务

法律支持

联系我们

友情链接