接收服务端回调

服务端回调概述

即时通讯业务提供以下服务端回调，支持将业务的数据、状态通知同步到您设置的回调地址。所有服务端回调均需要在控制台启用。

您可以访问以下文档，了解如何在控制台配置并启用回调，以及如何解析回调数据：

• 用户在线状态：实时将用户状态同步到设置的 App 服务器地址。
• 全量消息路由：实时将消息同步到设置的 App 服务器地址。

回调签名规则

即时通讯相关回调服务的签名规则，适用于用户在线状态、全量消息路由。

规则说明

即时通讯服务向应用服务器推送数据（调用应用服务器接口）时会添加 4 个 POST 请求参数（在 URL 上添加的参数），具体如下：

名称	类型	说明
appKey	String	应用和环境的 App Key，可从控制台获取。
nonce	String	随机数，不超过 18 个字符。
timestamp	String	时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数。
signature	String	数据签名。

计算 Signature (数据签名)

将系统分配的 App Secret、Nonce (随机数)、Timestamp (时间戳)三个字符串按顺序拼接成一个字符串，进行 SHA1 哈希计算。

校验示例

PHP 语言的代码示例：

$appSecret = 'your-own-app-secret'; // 请替换为您从开发者平台获取的 App Secret。
$nonce = $_GET['nonce']; // 获取随机数。
$timestamp = $_GET['timestamp']; // 获取时间戳。
$signature = $_GET['signature']; // 获取数据签名。
$local_signature = sha1($appSecret.$nonce.$timestamp); // 生成本地签名。
if(strcmp($signature, $local_signature)===0){
	// TODO: 此处添加业务逻辑。
	echo 'OK';
} else {
	echo 'Error';
}