PDF《云通信》

云通信 版权所有:腾讯云计算(北京)有限责任公司 第1 共87页 云通信 第三方回调 产品文档 云通信 版权所有:腾讯云计算(北京)有限责任公司 第2 共87页 【版权声明】 ?2013-2019 腾讯云版权所有 本文档著作权归腾讯云单独所有,未经腾讯云事先书面许可,任何主体不得以任何形式复制、修改、抄袭、传播全 部或部分本文档内容.

【商标声明】 及其它腾讯云服务相关的商标均为腾讯云计算(北京)有限责任公司及其关联公司所有.本文档涉及的第三方主体 的商标,依法由权利人所有. 【服务声明】 本文档意在向客户介绍腾讯云全部或部分产品、服务的当时的整体概况,部分产品、服务的内容可能有所调整.您 所购买的腾讯云产品、服务的种类、服务标准等应由您与腾讯云之间的商业合同约定,除非双方另有约定,否则, 腾讯云对本文档内容不做任何明示或模式的承诺或保证. 云通信 版权所有:腾讯云计算(北京)有限责任公司 第3 共87页 文档目录 第三方回调 第三方回调简介 第三方回调配置 回调命令列表 在线状态相关回调 状态变更回调 资料关系链相关回调 添加好友之前回调 添加好友之后回调 添加好友回应之前回调 删除好友之后回调 添加黑名单之后回调 删除黑名单之后回调 单聊消息相关回调 发单聊消息之前回调 发单聊消息之后回调 群组系统相关回调 创建群组之前回调 创建群组之后回调 申请入群之前回调 拉人入群之前回调 新成员入群之后回调 群成员离开之后回调 群内发言之前回调 群内发言之后回调 群组满员之后回调 群组解散之后回调 群组资料修改之后回调 回调双向认证配置指南 Apache双向认证配置指南 Nginx双向认证配置指南 云通信 版权所有:腾讯云计算(北京)有限责任公司 第4 共87页 第三方回调简介 为方便您精细化控制 App 的功能形态,云通信为您提供了完全免费且强大的回调能力.所谓回调,即云通信 IM 后 台会在某一事件发生之前或者之后,向App 的后台服务器发送请求,App 后台可以据此进行必要的数据同步,或者 干预事件的后续处理流程.云通信目前支持的回调请参见 回调命令列表. 第三方回调将通过 HTTP/HTTPS 请求的方式发送给 App 后台服务器,App 后台服务器需要处理云通信的回调请求 并尽快进行应答.以 群内发言之前回调 为例,云通信 IM 后台会在下发该消息之前回调 App 后台服务器,并根据 回调结果决定该消息是否应当下发,App 不仅可以基于该回调来实现消息同步,而且可以进行发消息安全打击.回 调业务流程如下图所示: 回调分类 第三方回调 第三方回调简介 最近更新时间:2019-01-29 18:30:07 云通信 版权所有:腾讯云计算(北京)有限责任公司 第5 共87页 从功能角度来看,回调可以分为四大类: 在线状态回调 关系链相关回调 单发消息回调 群组相关回调 从处理角度来看,回调可以分为以下两大类: 1. 事件发生之前回调:回调的主要目的在于让 App 后台可以干预该事件的处理逻辑,云通信会根据回调返回码确定 后续处理流程(例如发送群消息之前回调). 2. 事件发生之后通知:回调的主要目的在于让 App 后台实现必要的数据同步,云通信忽略回调返回码(例如群组成 员退群之后通知). 回调协议 第三方回调基于 HTTP/HTTPS 协议,App 后台需要向云通信提供回调 URL,云通信使用 POST 请求的方式来向 App 后台发起回调请求.云通信在发起回调时,会在 App 提供的 URL 之后增加如下几个参数: 参数 含义 SdkAppid App 在云通信分配的应用标识 CallbackCommand 回调命令字 contenttype 可选,通常值为 json ClientIP 客户端 IP 地址 OptPlatform 客户端平台,对应不同的平台类型,可能的取值有: RESTAPI(使用 REST API 发送请求)、Web(使用 Web SDK 发送请求)、 Android、iOS、Windows、Mac、Unkown(使用未知类型的设备发送请求) 具体的回调内容则会包含在 HTTP 请求包体中,参见下文回调示例. 回调示例 回调请求示例: POST /?SdkAppid=888888&