开通回调通知服务,并且订阅的事件发生前或发生后,你指定的 URL 会收到来自 IM 服务端的消息回调。相关事件的信息包含在回调字段中。
参考本文,了解消息回调的格式。
当你设置关注的回调事件发生前或发生后,IM 服务端会向你指定接收回调的 URL 地址发起 HTTP POST 请求。具体回调信息包含在 Request Body 中。
当前 IP 地址+端口号类型的 IPV4 回调地址已不再支持。
Request Body 中以 Json 格式包含回调信息,具体字段如下:
参数名 | 类型 | 示例值 | 描述 |
---|---|---|---|
EventType | String | SendMessage | 事件类型。目前支持的事件类型参看回调事件列表 |
EventData | String | / | 具体的事件内容,格式为 Json |
EventTime | String | 1970-07-01T00:00:00.000000000Z | 事件产生时间,格式为 UTC |
EventId | String | / | 事件 Id,具有唯一性,可用于去重 |
AppId | String | Your_AppId | IM 应用的唯一标识 |
Version | String | 2020-12-01 | 事件的版本号 |
Signature | String | / | 回调签名。 |
Nonce | String | / | 签名随机数 4位 |
注:
- 关于目前支持消息回调的事件(
EventType
)和对应的事件内容 (EventData
),参看 回调事件列表。- 当前不保证回调事件的唯一性。建议你可以使用
EventId
对事件回调进行去重。