通知接口
所有文档

          媒体内容审核 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库接口