跳到主要内容

IM 消息审核结果回调

在控制台的 IM & 音视频审核 页面开通 IM 审核服务后，可使用审核结果回调，实时接收审核结果详情。

提示

该回调服务仅返回 IM & 音视频审核 的审核结果。

配置审核结果回调地址​

请在控制台的IM & 音视频审核页面配置回调地址。配置后 15 分钟内生效。请确保公网可访问您提供的回调接收地址。

回调方法​

请求方法： POST

数据格式： application/json

即时通讯服务端会在 POST 请求头部添加签名参数，您可通过签名验证调用者身份，并确保数据有效性，详见 服务端回调签名。

回调正文参数​

该回调服务的 HTTP 请求正文数据格式为 application/json，包含具有以下结构的 JSON 对象：

名称类型说明
resultInt返回审核是否通过。10000 为审核通过；10001 为审核不通过。审核结果详情在 resultDetail 字段中返回。
contentString返回审核的消息内容，详见下方 content 结构说明。
msgUIDString消息 ID。
serviceProviderString审核渠道商标识。
resultDetailString审核结果详情，直接返回审核服务商的审核结果 JSON 结构响应体，详见下方 resultDetail 说明。

  • content 结构说明：

    名称类型说明
    appKeyStringappkey
    fromUserIdString发送者 ID
    targetIdString接收者 ID
    toUserIdsString群成员 ID 列表（以英文逗号分隔）。发送群聊定向消息时，接收消息的群成员用户 ID 列表。非群定向消息时为空。
    conversationTypeString会话类型。支持的会话类型包括：PERSON（二人会话）、GROUP（群组会话）、TEMPGROUP（聊天室会话）、ULTRAGROUP（超级群会话）。
    objectNameString消息类型。一般包括：RC:TxtMsg（文本消息 ）、RC:ImgMsg（图片消息）、RC:VcMsg（语音消息）、RC:HQVCMsg（高清语音消息）、RC:SightMsg（小视频消息）。
    messageString消息体内容，详细查看消息结构文档。
    extraContentObject消息扩展的内容，JSON 结构的 Key、Value 对，如：{"type":"3"}。Key 最大 32 个字符，支持大小写英文字母、数字、 特殊字符+ = - _ 的组合方式，不支持汉字。Value 最大 4096 个字符。
    clientOsString客户端类型，包括：iOS、Android、HarmonyOS、Websocket、MiniProgram（小程序）、PC、Server（通过 Server API 发送，需要开通 Server API 发送消息进行消息路由功能）。
    messageTimeLong服务端收到客户端发送消息时的服务器时间，精确到毫秒
    messageIdString消息 ID

  • resultDetail 说明：直接返回审核服务商的审核结果响应体。

    • 如果您在控制台选择的审核服务商为数美，resultDetail 中为数美审核的返回结果，详细结构说明请参见以下数美文档。注意，文本和图片审核返回的是单条同步请求的响应体，音频和视频审核返回的是单条异步的响应体。数美返回的审核结果响应体中的 riskLabel1 中携带了审核不通过的具体原因。

      • 文本消息审核结果 参见该数美文档中的「返回结果」。文本审核返回的是单条同步请求的响应体。
      • 图片消息审核结果 参见该数美文档中的「同步返回结果」。图片审核返回的是单条同步请求的响应体。
      • 语音消息审核结果 参见该数美文档中的「回调结果」。音频审核返回的是单条异步的响应体。
      • 小视频消息审核结果 参见该数美文档中的「异步回调结果」。视频审核返回的是单条异步的响应体。

回调请求示例​

以下示例您在开通服务页面配置的接收地址为 http://example.com/review_result.php

HTTP
POST review_result.php HTTP/1.1
Host: example.com
RC-App-Key: uwd1c0sxdlx2
RC-Timestamp: 1408710653491
RC-Nonce: 14314
RC-Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/json

{
  "result":10000,
  "content":“{****}”,//审核的消息结构 JSON
  "serviceProvider":"ShuMei",
  "msgUID":"596E-P5PG-4FS2-7OJK",
  "resultDetail":"{****}";//审核结果详细 JSON 结构
}

响应回调请求​

提示
  • 只要有 HTTP 200 OK 成功响应，服务端会认为状态已经同步。
  • 如果应答超时 5 秒，服务端会再尝试推送 2 次，如果仍然失败，将不再同步此条状态。
  • 如短时间内有大面积超时，将暂时停止请求您的服务器，1 分钟后会继续发送回调请求。