内容安全支持以异步消息通知的方式向您发送内容识别和您自助审核的结果。如果您的业务需要使用或集成相关数据,则可以配置回调通知。本文介绍了配置内容检测API回调通知的操作方法。

背景信息

说明 内容检测API和OSS违规检测均支持回调通知。关于OSS违规检测回调通知,请参见OSS违规检测回调通知
内容检测API回调通知分为扫描结果回调通知和审核结果回调通知。
  • 扫描结果回调通知:内容安全完成检测请求后,服务端将识别的结果以POST请求的方式,发送到您设置的HTTP回调通知地址。
  • 审核结果回调通知:您通过自助审核或调用反馈接口修改识别的结果后,内容安全服务端将审核结果以POST请求的方式,发送到您设置的HTTP回调通知地址。更多信息,请参见自助审核

相关概念

在配置回调通知前,请了解下表中描述的相关概念。

名称 说明
回调地址 回调地址是您在内容安全控制台配置的服务端地址,通常是您自己的业务服务器的公网地址。回调地址需要满足以下要求:
  • 应为HTTP、HTTPS协议接口的公网可访问的URL。
  • 支持POST方法。
  • 支持传输数据编码采用UTF-8。
  • 支持数据接收格式为applicationx-www-form-urlencoded
  • 支持表单参数checksumcontent
Seed Seed值用于校验发送到您设置的HTTP回调通知地址的请求是否来自内容安全服务端。
回调次数 您的服务端接收到内容安全推送的回调消息后,如果返回的HTTP状态码为200,表示接收成功;如果返回其他的HTTP状态码,均视为接收失败。如果接收失败,内容安全服务端会重复推送回调消息,直至您接收成功。内容安全最多重复推送回调消息16次。
回调数据 回调数据是内容安全服务端向您设置的回调通知地址返回的数据内容。回调数据的结构描述见表 1
表 1. 回调通知表单数据
名称 类型 描述
checksum String 总和校验码,由<用户uid> + <seed> + <content>拼成字符串,通过SHA256算法生成。用户UID即阿里云账号ID,可以在阿里云控制台,鼠标悬浮在右上角的头像上,查看上查询阿里云账号ID。
说明 为防篡改,您可以在获取到推送结果时,按上述算法生成字符串,与checksum做一次校验。
content String 字符串格式保存的JSON对象,请自行解析反转成JSON对象。关于content解析成JSON后的结构,请参见下文content说明
说明 在内容检测API和OSS违规检测中,content的参数结构不同。

扫描结果回调通知

内容检测API的异步检测接口均支持扫描结果回调,例如图片审核异步检测视频审核异步检测。您在发起异步调用时,如果希望内容安全向您返回扫描结果,则必须在请求参数中传入callback(回调地址)和seed(校验字符串)。

说明 在异步调用时如果不使用扫描结果回调,则您只能通过定期轮询的方式获取异步检测结果。

操作步骤