跳到主要内容

📞 回调说明

📢 OpenIM 提供了强大的回调功能。当某个特定事件发生前或后，OpenIMServer 通过HTTP/HTTPS 请求方式，主动通知 APP 的业务服务器。这样，APP 业务服务器可以依据这些回调来干预事件的后续流程或进行数据同步。

📑 回调分类​

根据处理时机，回调分为两大类：

  • 🚫 发送事件发生之前的回调：此类回调 (before 类型) 旨在让 APP 业务服务器干预事件处理，例如，对消息进行敏感词过滤。OpenIMServer 会根据回调返回来确定后续流程。

  • 📤 发送事件发生之后的通知：此类回调 (after 类型) 主要用于通知 APP 业务服务器进行数据同步，例如，用户加入群组。此时，OpenIMServer 会忽略回调的返回和错误码。

⚙️ 配置说明​

callback:
  url:
  beforeCreateGroup:
    enable: true
    timeout: 5
    failedContinue: true

  • url：APP业务服务器 callback 地址，支持HTTP/HTTPS
  • enable：是否开启此回调，true 为开启
  • timeout：响应超时时间（秒）
  • failedContinue：超时或者API失败后是否继续执行流程，一般只对before类型回调有效，true 为继续执行

🔄 回调协议​

OpenIMServer 利用第三方回调机制，基于 HTTP/HTTPS 协议。当发起回调请求时，OpenIMServer 采用 POST 请求方法来通知 APP 业务服务器。这些请求的具体内容将直接包含在请求包体中。