媒体内容审核VCR

    通知接口

    VCR 提供了通知回调功能,支持用户在创建视频审核时配置通知,便于用户及时收到视频审核完成的消息。

    目前如果用户需要使用通知,需要首先登录管理控制台,配置通知回调地址和通知名称,当创建视频审核时,您只需在请求参数或请求体中配置通知名称即可。

    通知格式

    如果用户在创建审核时配置了通知名称,那么在视频审核完成或审核失败时,VCR 会通知视频审核结果。

    通过HTTP POST发送给用户创建通知时配置的回调地址,请求响应的 HTTP 状态码为 200 时视为通知成功,否则将会在3小时内不断地进行重试。

    回调语法

    POST <notification_endpoint> HTTP/1.1

    回调体

    参数 类型 描述
    messageId String 通知消息ID
    messageBody String 通知消息,JSON串

    用户可以使用常用的JSON库对messageBody进行解析,其格式和视频审核结果查询结果一致。

    • 注:如需要在回调时增加鉴权,请发工单进行咨询与配置。

    回调示例

    示例一:BOS视频回调

    POST <notification_endpoint> HTTP/1.1
    {
        "messageId": "message_id",
        "messageBody": "{\"source\": \"bos://testbucket/dir/video.mp4\",\"description\": \"desc\",\"status\": \"FINISHED\",\"createTime\": \"2017-03-22T12:00:00Z\",\"finishTime\": \"2017-03-22T12:06:48\",\"label\": \"REVIEW\",\"results\": [{\"type\": \"sexual_porn\",\"items\": [{\"subType\": \"behavior\",\"target\": \"audio\",\"startTimeInSeconds\": 0,\"confidence\": 68,\"label\": \"REVIEW\"}]}]}"
    }

    示例二:VOD媒资回调

    POST <notification_endpoint> HTTP/1.1
    {
    	"messageId": "message_id",
    	"messageBody": "{\"source\": \"vod://mda-fhepatsnpn4rk9z\",\"mediaId\": \"mda-fhepatsnpn4rk9z\",\"description\": \"desc\",\"status\": \"FINISHED\",\"createTime\": \"2017-03-22T12:00:00Z\",\"finishTime\": \"2017-03-22T12:06:48\",\"label\": \"REVIEW\",\"results\": [{\"type\": \"sexual_porn\",\"items\": [{\"subType\": \"behavior\",\"target\": \"audio\",\"startTimeInSeconds\": 0,\"confidence\": 68,\"label\": \"REVIEW\"}]}]}"
    }

    示例三:URL视频回调

    POST <notification_endpoint> HTTP/1.1
    {
        "messageId": "message_id",
        "messageBody": "{\"source\": \"http://test.domain.com/dir/video.mp4\",\"description\": \"desc\",\"status\": \"FINISHED\",\"createTime\": \"2017-03-22T12:00:00Z\",\"finishTime\": \"2017-03-22T12:06:48\",\"label\": \"REVIEW\",\"results\": [{\"type\": \"sexual_porn\",\"items\": [{\"subType\": \"behavior\",\"target\": \"audio\",\"startTimeInSeconds\": 0,\"confidence\": 68,\"label\": \"REVIEW\"}]}]}"
    }
    上一篇
    直播审核接口
    下一篇
    自定义face库接口