服务端集成概述
您可以在您的应用服务端(App Server)集成即时通讯服务,构建完整和丰富的业务体验。
即时通讯服务端 API 支持从应用自身的服务端(App Server)向即时通讯服务端发送请求,例如将 App 用户接入即时通讯服务(注册用户)、发送消息。部分服务管理类接口,以及高级扩展特性仅在 IM Server API 中提供,例如 系统通知、在线用户广播、创建群组、用户封禁等。关于 API 的完整功能、调试工具、注意事 项的详细描述,请参见 API 接口列表。
即时通讯提供多个服务端回调,支持将即时通讯服务中的部分数据和状态同步给指定的应用后端服务,例如用户在线状态变更、聊天室房间状态变更等。支持通过回调响应正文的参数控制消息是否发送给接收者。所有服务端回调均需要在控制台分别配置回调地址并启用。详见服务端回调。
交互关系图
提示
所有 Server API 接口必须通过 App Server 进行调用。切勿通过客户端直接调用 Server API 接口,避免 App Secret 泄漏等问题。
本文将以 注册用户 为例,帮助您快速了解服务端 API 接口的使用方式。
提示
IM Server API 的主要功能之一是注册用户 。您必须从 App 后端必须调用该接口,使用 App 的用户 ID 换取 Token,App 用户才能接入即时通讯服务。
前提条件
在开始调用服务端 API 接口之前,请确保:
- 已在控制台创建应用,并获取了开发环境或者生产环境下有效的 App Key / App Secret。
- 已准备好自己的客户端,搭建相关的业务场景。例如,调用服务端 API 接口注册用户之后,可以使用获取到的 Token 在自己的客户端上建立 IM 连接。
- 推荐您提前了解 IM Server API 的默认行为与配置,以使整体接入体验更为顺畅。