文档中心

环信即时通讯通过 REST 平台提供 REST API，你可以通过你的业务服务器向环信 REST 服务器发送 HTTP 请求，在服务端实现实时通信。

另外环信 Server SDK 提供了用户、消息、群组、聊天室等资源的操作管理能力，具体参见：Java Server SDK 和 PHP Server SDK。

#REST 平台架构

环信即时通讯 REST 平台提供多租户架构，以集合（Collection）的形式管理资源，一个 Collection 包含如下子集：

• 数据库（database）
• 组织（orgs）
• 应用（apps）
• 用户（users）
• 群组（chatgroups）
• 消息（chatmessages）
• 文件（chatfiles）

不同 org 之间的用户数据相互隔离；同一个 org 下，不同 app 之间的用户数据也相互隔离。一个 org 的数据架构如下图：

#前提条件

要调用环信即时通讯 RESTful API，请确保满足以下要求：

• 已在环信即时通讯控制台 开通配置环信即时通讯 IM 服务。
• 已从服务端获取 app token，详见 使用 App Token 鉴权。

#请求结构

#认证方式

环信即时通讯 REST API 要求 Bearer HTTP 认证。每次发送 HTTP 请求时，都必须在请求头部填入如下 Authorization 字段：

Authorization: Bearer YourAppToken

为提高项目的安全性，环信即时通讯使用 Token（动态密钥）对即将登录即时通讯系统的用户进行鉴权。即时通讯 RESTful API 推荐使用 app token 的鉴权方式，详见 使用环信 App Token 鉴权。

#请求域名

环信不同数据中心的 REST API 请求域名 {host}：

应用所在数据中心可以在环信用户管理后台 > 应用列表找到对应的 App Key 点击 查看 > 即时通讯 > 服务概览 中查看：

#通信协议

环信即时通讯 REST API 支持 HTTP 和 HTTPS 协议。

#数据格式

• 请求：请求的格式详见具体 API 中的示例。
• 响应：响应内容的格式为 JSON。

所有的请求 URL 和请求包体内容都是区分大小写的。

#REST API 概览

#用户体系管理

用户体系管理 功能，包括注册、获取、修改和删除用户等。

#设置消息离线推送

设置推送消息 展示方式、显示昵称、免打扰模式等。

#消息发送及文件下载

消息管理 内容包括：从服务端发送文本、图片、语音、视频、透传、扩展、文件、自定义等各种类型的消息，以及上传和下载文件。

#用户属性

用户属性管理 包括：设置、获取和删除用户属性。

#用户关系管理

用户关系管理 包括：管理用户的好友列表和黑名单。

#群组管理

群组管理 包括创建、获取、修改和删除群组。

#群组成员管理

管理群组成员，包括添加、移除群组成员关系列表，转让群主等。

#管理子区

子区管理 包括子区的创建、获取、修改、删除等。

#管理子区成员

子区成员管理，包括对子区的加入和踢出等管理功能。

#聊天室管理

聊天室管理 包括创建、获取、修改、删除聊天室。

#聊天室成员管理

聊天室成员管理 包括：添加、获取、修改和删除聊天室中的成员。