http://docs-ai.easemob.com/ 2026-04-05T09:49:07+00:00 http://docs-ai.easemob.com/ http://docs-ai.easemob.com/lib/tpl/haozki-2016-01-25/images/favicon.ico text/html 2019-03-12T03:24:48+00:00 http://docs-ai.easemob.com/start/100serverintegration/10intro?rev=1552361088&do=diff 入门 ---------- 环信服务器端 REST 平台概述 关于REST REST（Representational State Transfer）是一种轻量级的 Web Service 架构风格，可以翻译成“表述性状态转移”，实现和操作明显比 SOAP 和 XML-RPC 更为简洁，可以完全通过 HTTP 协议实现，还可以利用缓存 Cache 来提高响应速度，性能、效率和易用性上都优于SOAP协议。 text/html 2019-03-12T03:24:48+00:00 http://docs-ai.easemob.com/start/100serverintegration/20users?rev=1552361088&do=diff 用户体系集成 ---------- 数据结构 环信作为一个聊天通道，只需要提供环信 ID 和密码就够了。 名称 字段名 数据类型 描述环信 ID username String 环信 ID 是环信用户的唯一标识，在 AppKey 的范围内唯一 text/html 2019-03-12T03:24:48+00:00 http://docs-ai.easemob.com/start/100serverintegration/30chatlog?rev=1552361088&do=diff 聊天记录 ---------- 环信支持 APP 把聊天记录通过 REST 接口导出。 聊天记录数据结构 { "msg_id": "5I02W-16-8278a", //消息ID "timestamp": 1403099033211, //消息发送时间 "direction":"outgoing", "to": "1402541206787", //接收人的username或者接收group的ID "from": "zw123", //发送人username "chat_type": "chat", //用来判断单聊还是群聊。chat: 单聊；groupchat: 群聊 "payload": { "bodies": [ //消息bodies { //不同的消息类型，bodies数据格式见如下几条 } ], "ext": { //自定义扩展属性 "key1": "value1", //你设置… text/html 2019-03-12T03:24:48+00:00 http://docs-ai.easemob.com/start/100serverintegration/40fileoperation?rev=1552361088&do=diff 文件上传下载 ---------- 环信使用 REST 的方式来实现语音和图片等文件的上传下载。同时，为了保证聊天文件的安全，我们的 API 保证了以下几点： * 只有 APP 的登录用户才能够上传文件。 text/html 2019-03-12T03:24:48+00:00 http://docs-ai.easemob.com/start/100serverintegration/50messages?rev=1552361088&do=diff 发送消息 ---------- 聊天相关 API。 流程说明 * 发送文本/透传消息：直接编辑内容发送。 * 发送图片/语音/视频消息：需要先上传这三类文件，从接口返回值中获取到相应的参数，按照 API text/html 2019-03-12T03:24:48+00:00 http://docs-ai.easemob.com/start/100serverintegration/60groupmgmt?rev=1552361088&do=diff 群组管理 ---------- 环信提供了 REST API 来管理 APP 中的群组。 单个APP创建群组数量有限制，如需增加可根据具体业务联系商务解决。单用户ID只能加入500个群。 群组数据结构 字段名 类型 描述id text/html 2019-03-12T03:24:48+00:00 http://docs-ai.easemob.com/start/100serverintegration/70chatroommgmt?rev=1552361088&do=diff 聊天室管理 ---------- 环信提供了 REST API 来管理 APP 中的聊天室。 单个APP创建聊天室数量有限制，如需增加可根据具体业务联系商务解决。单用户ID只能加入500个聊天室。 聊天室数据结构 名称 text/html 2019-03-12T03:24:48+00:00 http://docs-ai.easemob.com/start/100serverintegration/group-and-chatroom-changes?rev=1552361088&do=diff 新版群组/聊天室服务 REST API差异说明v2 (最新更新时间: 2017-01-06) 第一版差异说明发出后，我们收到了一些开发者的反馈。根据这些反馈，我们对新版群组/聊天室的异常、状态码进行了调整和优化。相比2017-01-03第一个版本，主要更新内容： text/html 2019-03-12T03:24:48+00:00 http://docs-ai.easemob.com/start/100serverintegration/start?rev=1552361088&do=diff 服务端集成 * 入门 * 用户体系集成 * 聊天记录 * 文件上传下载 * 发送消息 * 群组管理 * 聊天室管理