主题 : 请问用环信注册微博的时候出现什么WBMFPRSA&&然后查资料出现说什么应用程序防火墙的问题
级别: 新手上路
可可豆: 102 CB
威望: 112 点
在线时间: 554(时)
发自: Web Page
来源于&&分类
请问用环信注册微博的时候出现什么WBMFPRSA&&然后查资料出现说什么应用程序防火墙的问题&&&
环信微博注册key的时候出现崩溃，
图片:11.jpg
级别: 新手上路
UID: 210164
可可豆: 106 CB
威望: 101 点
在线时间: 39(时)
发自: Web Page
Re:我没有使用环信但是也出现WBMFPRSA
我也碰到了与上面一样的问题。哪位也遇到过这样问题，即在cocos2d-x集成ShareSDK时遇到，如何解决？
googleman2099
级别: 新手上路
可可豆: 1 CB
威望: 1 点
在线时间: 20(时)
发自: Web Page
请问有没有解决这个问题
级别: 新手上路
可可豆: 2 CB
威望: 2 点
在线时间: 53(时)
发自: Web Page
手动添加WeiBoSDK.bundle.Target -& Build Phase -& Copy Bundle Resources
关注本帖(如果有新回复会站内信通知您)
iPhone5的分辨率？ 正确答案:
发帖、回帖都会得到可观的积分奖励。
按"Ctrl+Enter"直接提交
关注CocoaChina
关注微信 每日推荐
扫一扫 浏览移动版iOS:即时通讯之&掌握篇 环信& - 简书
下载简书移动应用
写了37896字，被1444人关注，获得了1000个喜欢
iOS:即时通讯之&掌握篇 环信&
什么是环信?1.环信是一个第三平台，提供即时通信(IM–Instant Messaging )的服务2.环信是在XMPP的基础上进行二次开发3.环信在网络上传输的数据也是XML4.使用环信，不用自己搭建服务器，节约成本5.环信日活30万以下,永远免费为什么要选择环信?数据来源艾瑞: 数据来源易观:
集成环信前提准备:1.注册成为环信开发者
2.在开发者后台创建APP获取Key
3.下载官方SDK DEMO
集成SDK步骤:1.导入SDK
2. 设置工程属性
2.2 SDK依赖库有
注意:(如果使用的是xcode7，后缀为tbd) &官网有提示&2.3 如果项目中使用-ObjC有冲突,可以添加-force_load来解决
2.4 SDK不支持bitcode,向Build Settings → Linking → Enable Bitcode中设置NO。编译工程
以上步骤进行完后，编译工程，如果没有报错，恭喜你，集成sdk成功，可以进行下一步了。SDK同步/异步方法区分:SDK中，大部分与网络有关的操作，提供的是同步方法(注:同步方法会阻塞主线程,需要用户自己创建异步线程执行;带有async的方法为异步方法)初始化SDK1.引入相关头文件 #import “EMSDK.h”2.在工程的AppDelegate中的以下方法中，调用SDK对应方法:
调用的SDK接口参数解释如下：
1.AppKey: 区别app的标识，2.apnsCertName: iOS中推送证书名称。3.环信为im部分提供了apns推送功能，如果您要使用，请跳转到注册:1.注册模式分两种，开放注册和授权注册。只有开放注册时，才可以客户端注册。2.开放注册是为了测试使用，正式环境中不推荐使用该方式注册环信账号， 授权注册的流程应该是您服务器通过环信提供的rest api注册，之后保存到您的服务器或返回给客户端。
登录：调用SDK的登录接口进行的操作；
自动登录:自动登录：即首次登录成功后，不需要再次调用登录方法，在下次app启动时，SDK会自动为您登录。并且如果您自动登录失败，也可以读取到之前的会话信息。配置是否进行自动登录SDK中自动登录属性默认是关闭的，需要您在登录成功后设置，以便您在下次app启动时不需要再次调用环信登录，并且能在没有网的情况下得到会话列表。
自动登录在以下几种情况下会被取消
1.用户调用了SDK的登出动作;
2.用户在别的设备上更改了密码, 导致此设备上自动登陆失败;
3.用户的账号被从服务器端删除;
4.用户从另一个设备登录，把当前设备上登陆的用户踢出.
所以，在您调用登录方法前，应该先判断是否设置了自动登录，如果设置了，则不需要您再调用
SDK中，如果发生自动登录，会有以下回调
重连:当掉线时，IOS SDK会自动重连，只需要监听重连相关的回调，无需进行任何操作。
退出登陆:退出登录分两种类型：主动退出登录和被动退出登录。
主动退出登录：调用SDK的退出接口；
被动退出登录： 1、 正在登陆的账号在另一台设备上登陆； 2、 正在登陆的账号被从服务器端删除。
logout:YES：是否解除device token的绑定，在被动退出时SDK内部处理,不需要调用退出方法
被动退出登录:回调方法监听:
还有很多很多功能,而且 写的非常非常清楚!好友管理
注：环信不是好友也可以聊天，不推荐使用环信的好友机制。如果你有自己的服务器或好友关系，请自己维护好友关系。获取好友列表获取好友列表，环信提供了两种方法。1. 从服务器获取所有的好友
2. 从数据库获取所有的好友
发送加好友申请环信iOS SDK提供了添加好友的方法如果您已经发过，并且对方没有处理，您将不能再次发送
实时通话管理客户端1.发起实时通话
2.被叫方同意实时通话
3.结束实时通话
4.实时通话实例
EaseUI使用指南EaseUI是一个UI库，封装了IM功能常用的控件、fragment等等，旨在帮助开发者快速集成环信sdkeaseui及demo的github下载地址为：；，3.0的代码需要切换到sdk3.0分支注意：因为这是一个ui库，后续很可能还会继续改动，新旧版本在api的兼容上不会像im sdk那样绝对的兼容。(官网有提示)代码导入easeui库的代码是开源的，下载的sdk压缩包里面已经包含此库，解压后路径为/examples/easeuiEclipse中导入：1.先把easeui项目导入到eclipse中2.在自己的项目中把easeui作为一个library引入。右键你的项目→Android→点击右下角的Add按钮→选中EaseUI→OK→OKAndroid studio中导入：打开你的AS项目→File→New→Import Module→选择或输入easeui库路径→Next→Next→Finish导入完可能会有如下错误：
找到相应报错的地方把swipeRefreshLayout.setColorSchemeResources改成swipeRefreshLayout.setColorScheme，ViewCompat.getX改成new ViewCompat().getX,然后重新build即可；或者把v4包的版本号加大，譬如compile 'com.android.support:support-v4:23.1.1'。主要fragment1.EaseConversationList - 聊天页面，最主要的fragment2.EaseContactListFragment - 联系人页面3.EaseConversationListFragment - 会话列表页面
1.EaseTitleBar - 标题栏2.EaseChatMessageList - 聊天消息列表控件3.EaseConversationList - 会话列表控件4.EaseContactList - 联系人列表页面5.EaseChatInputMenu - 聊天输入菜单栏其他子控件，后文会做详细介绍这里对聊天页面几个控件做简单图示：
类似这些功能:
这里都有介绍,只不过觉得这么好的东西放在官网没人看,太可惜了... API大致变动介绍:
都是官网的东西,与君共勉!
如果觉得我的文章对您有用，请随意打赏。您的支持将鼓励我继续创作！
打开微信“扫一扫”，打开网页后点击屏幕右上角分享按钮
被以下专题收入，发现更多相似内容：
如果你是程序员，或者有一颗喜欢写程序的心，喜欢分享技术干货、项目经验、程序员日常囧事等等，欢迎投稿《程序员》专题。
专题主编：小...
· 143612人关注
玩转简书的第一步，从这个专题开始。
想上首页热门榜么？好内容想被更多人看到么？来投稿吧！如果被拒也不要灰心哦～入选文章会进一个队...
· 122660人关注
关注互联网、科技。
**诚邀科技爱好者一起管理这个专题，私信我。
不定期会精选一些好的文章发在公众号（joojencom）...
· 27401人关注
如果觉得我的文章对您有用，请随意打赏。您的支持将鼓励我继续创作！
选择支付方式：集成笔记：环信移动客服如何实现全媒体接入--百度百家
集成笔记：环信移动客服如何实现全媒体接入
分享到微信朋友圈
作为一名常年混迹imGeek开发者社区的程序猿，本着响应社区号召的“我为人人，人人为我”口号，赠人玫瑰，手留余香。本篇集成笔记主要参考环信官网移动客服集成文档
作为一名常年混迹imGeek开发者社区的程序猿，本着响应社区号召的“我为人人，人人为我”口号，赠人玫瑰，手留余香。本篇集成笔记主要参考环信官网移动客服集成文档&（地址：/doku.php?id=start:475mobilecs）。写这篇笔记主要是为了让大家更直观的了解和解决大家的常见问题，比如：“环信移动客服是什么？我能不能使用环信移动客服？怎么集成环信移动客服？”以及在集成过程中碰到的常见问题，欢迎大家一起交流研究。
环信移动客服是全球首创的全媒体智能云客服平台。支持全媒体接入，包括网页在线客服、社交媒体客服（微博、微信）和移动端客服等多种渠道。基于环信业界领先的IM长连接技术保证消息必达，并通过独创的智能机器人技术极大降低人工客服工作量。
环信移动客服不仅支持PC端客服后台，同时支持移动端手机客服后台操作，真正帮助商家做到随时随地7*24小时服务客户。
全媒体接入集成文档如下：
集成环信移动客服前需注册环信客服账号，并登录。（环信客服注册地址：/mo/register&）
一，网页在线客服集成：
网页插件集成移动客服是比较简单，原理是在自己网站的&/body&标签之前加入一段由环信提供的js，即可完成环信在线客服的植入，实现访客在网页端与在线客服的沟通。
这段js获取步骤如下：管理员模式下==》渠道设置==》网页插件
下面来讲下网页插件的功能介绍和自定义开发（V4.1版本）：功能介绍可参考imgeek社区新产品发布：/article/
一些常见的自定义开发：
Q:网页插件怎么集成自定义按钮？A:首先，将插件JS串中的hide=false修改为hide=true；其次，在你网页的目标元素上添加如下超链接，例如：&a&href="javascript:;"&onclick="easemobIM()"&xxxxID=0000&你的目标元素&/a&，即可完成自定义客服按钮。
Q:网页插件怎么区分技能组？A:JS串参考：&/webim/im.html?tenantId=xxxx&emgroup=技能组名称（注意：技能组名称外面没有单引号）
二，移动端客服集成：
移动端客服（手机App）集成可分为以下两步：
1：先在客服后台创建一个关联：管理员模式下==》渠道设置==》手机APP&右上角添加环信关联。关联名称由自己定义，AppKey，ClientId，ClientSecret可以再环信开发者后台拿到（注册环信开发者账号/index_register.html&&注册完成创建应用--查看应用概况即可得到）。
这里详细介绍下im服务号，im服务号为自己应用下的一个im账号（不用为每个用户创建，根据自己业务逻辑指定一个或者多个）。
2：客户端写个联系客服按钮，点击联系客服，调用发消息方法，接收对象为客服后台创建的关联的im服务号，消息就会到客服后台，根据分配策略分配给对应的客服（V4.1版本客服坐席分配策略为：max(客服坐席可接待人数－客服坐席已接待人数）,&也就是说，新来会话会分配给理论最闲的那个客服坐席）。
一些常见的自定义开发：
指定客服、技能组、满意度调查、显示用户信息可参考（原理为联系客服时通过传入扩展属性“键值对”，由客服后台解析辨别。“键”是环信实现约定好的，“值”是自定义。）文档地址：/doku.php?id=start:475mobilecs:30msgextension
这里列举几个常见的用户信息实现遇到的问题：
Q:已经按照文档传入用户信息，为什么客服后台还是没有看到用户信息？A:客服关闭会话，再次联系客服就行，已经建立的会话目前没有刷新访客昵称。
Q:之前传入用户信息在客服后台显示了，后来传入新的用户信息为什么客服后台没有更新？A:已经在客服后台显示的用户信息不会随着扩展属性的更新而更新，目前的设计是访客第一次进入时展示信息给客服辨别，后续由客服手动备注。
PS:如果自己APP&是基于H5开发的，或者不想集成环信im怎么使用环信的移动客服，可以参考之前的网页插件集成，将那段js中的tenantID填入以下网址中xxxx的位置：/webim/im.html?tenantId=xxxx在自己APP中点击联系客服跳转到这个H5会话窗口即可。&
三，微信公众号集成：
微信公众号集成需要注意的是个人的订阅号、测试公众号等，微信均没有开通客服接口的权限，所以粉丝收不到客服消息。
微信公众号集成分以下几类：
1：直接授权（通过在客服后台管理员模式==》渠道设置==》微信公众号&添加微信公众号即可）。需要注意的是授权以后自己之前对微信公众号所做的开发都不能使用，微信用户通过微信的输入框直接联系客服后台坐席。
2：通过自定义菜单栏点击联系客服
可以在微信公众号自定义菜单栏，点击跳转到环信指定的网址（这个地址可参考之前的网页插件集成，将那段js中的tenantID填入以下网址中xxxx的位置：/webim/im.html?tenantId=xxxx&）
3：回调集成（需要开发者，涉及到服务端程序的集成）
实现原理为环信发消息给微信，是通过环信的实时消息旁路接口。微信发消息给环信，是通过环信提供的REST&API发消息接口。
按照以下步骤：
1/在微信公众号开发者设置第三方服务器接收微信公众号的消息进行业务逻辑处理。
2/调用环信rest接口将消息发给客服后台绑定的IM服务号（文档地址/doku.php?id=start:100serverintegration:50messages）。
3/客服的回复消息是到环信服务器，通过回调接口把这消息转发到用户指定的服务器（需要符合环信格式，配置消息回调可联系环信在线技术支持）。
4/服务器拿到消息之后再推给微信粉丝就行。
PS:需要注意的是消息格式的变化（V4.1视频和位置暂不支持，会在后续版本提供支持）
四，微博集成：
微博集成目前支持私信、&@&，评论暂不支持（V4.1版本）。
集成方式:管理员模式下==》渠道设置==》微博公众号。
以上均为本人在集成环信移动客服时所做的笔记以及碰到的问题，同时，环信移动客服也在不断快速迭代更新，如有遗漏或者错误，请直接联系本人：。
分享到微信朋友圈
在手机阅读、分享本文
还可以输入250个字
推荐文章RECOMMEND
阅读：1187
阅读：2673
阅读：37万
阅读：17万
阅读：10万
热门文章HOT NEWS
不抛弃，不放弃
娱乐资本论
百度新闻客户端
百度新闻客户端
百度新闻客户端
扫描二维码下载
订阅 "百家" 频道
观看更多百家精彩新闻用户体系集成
环信作为一个聊天通道，只需要提供环信 ID 和密码就够了。
属性 字段名 数据类型 描述
环信 ID username String username 是环信用户的唯一标识，在 AppKey 的范围内唯一
用户密码 password String 用户登录环信使用的密码
当您申请了 AppKey 后，会得到一个 xxxx#xxxx 格式的字符串，这个就是您的 AppKey，下文中用到的：
org_name 对应#前面部分
app_name 对应#后面部分
环信 ID 规则
当 APP 和环信集成的时候，需要把 APP 系统内的已有用户和新注册的用户和环信集成，为每个已有用户创建一个环信的账号（环信 ID），并且 APP 有新用户注册的时候，需要同步的在环信中注册。
在注册环信账户的时候，需要注意环信 ID 的规则：
使用英文字母和（或）数字的组合
不能使用中文
不能使用 email 地址
不能使用 UUID
用户ID的长度在1k字节以内
中间不能有空格或者井号（#）等特殊字符
允许的用户名正则 “[a-zA-Z0-9_-]*”（a~z大小写字母/数字/横线/下划线），其他都不允许 如果是大写字母会自动转成小写
不区分大小写。系统忽略大小写，认为 AA、Aa、aa、aA 都是一样的。如果系统已经存在了环信 ID 为 AA 的用户，再试图使用 aa 作为环信 ID 注册新用户，系统返回用户名重复，以此类推。但是请注意：环信 ID 在数据上的表现形式还是用户最初注册的形式，注册时候使用的大写就保存大写，是小写就保存小写。即：使用 AA 注册，环信保存的 ID 就是 AA；使用 Aa 注册，环信保存的 ID 就是 Aa，以此类推。
另：本文档中可能会交错使用“环信 ID”和“环信用户名”两个术语，但是请注意，这里两个的意思是一样的。
因为一个用户的环信 ID 和他的在 APP 中的用户名并不需要一致，只需要有一个明确的对应关系。例如，用户名是 stliu@apache.org，当这个用户登录到 APP 的时候，可以登录成功之后，再登录环信的服务器，所以这时候，只需要能够从 stliu@apache.org 推导出这个用户的环信 ID 即可。
注意：以下所有 API 均需要 org 管理员或 APP 管理员权限才能访问。
强烈建议保护好 org 管理员，APP 管理员的用户名和密码以及 APP 的 client_id 和 client_secret，尽量只在 APP 的服务器后台对环信用户做增删改查的管理，包括新用户注册。为了您的信息安全，请一定不要将 org 管理员或 APP 管理员的用户名和密码写死在手机客户端中，因为手机 APP 很容易被反编译，从而导致别人获取到您的管理员账号和密码，导致数据泄露。
获取 APP 管理员 Token
环信提供的 REST API 需要权限才能访问，权限通过发送 HTTP 请求时携带 token 来体现，下面描述获取 token 的方式。说明：API 描述的时候使用到的 {APP 的 client_id} 之类的这种参数需要替换成具体的值。
重要提醒：获取 token 时服务器会返回 token 有效期，具体值参考接口返回的 expires_in 字段值。由于网络延迟等原因，系统不保证 token 在此值表示的有效期内绝对有效，如果发现 token 使用异常请重新获取新的 token，比如 http response code 返回 401。另外，请不要频繁向服务器发送获取 token 的请求，同一账号发送此请求超过一定频率会被服务器封号，切记，切记！！
使用 APP 的 client_id 和 client_secret 获取授权管理员 token
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
client_id 和 client_secret 可以在环信管理后台的 APP 详情页面看到。
Path: /{org_name}/{app_name}/token
HTTP Method: POST
URL Params: 无
Request Headers: {“Content-Type”:”application/json”}
Request Body: {“grant_type”: “client_credentials”,”client_id”: “{APP的client_id}”,”client_secret”: “{APP的client_secret}”}
Response Body:
access_token token 值
expires_in token 有效时间，以秒为单位，在有效期内不需要重复获取
application 当前 APP 的 UUID 值
可能的错误码：400（client_id 或 client_secret 错误）、5xx。详见：
curl 示例：
curl -X POST &/easemob-demo/chatdemoui/token& -d '{&grant_type&:&client_credentials&,&client_id&:&YXA6wDs-MARqEeSO0VcBzaqg11&,&client_secret&:&YXA6JOMWlLap_YbI_ucz77j-4-mI0dd&}'
Response 示例：
&access_token&:&YWMtWY779DgJEeS2h9OR7fw4QgAAAUmO4Qukwd9cfJSpkWHiOa7MCSk0MrkVIco&,
&expires_in&:5184000,
&application&:&c03b3e30-046a-11e4-8ed1-5701cdaaa0e4&
IM 用户管理
注册 IM 用户[单个]
在 URL 指定的 org 和 APP 中创建一个新的用户，分两种模式：开放注册和授权注册。
“开放注册”模式：注册环信账号时，不用携带管理员身份认证信息；
“授权注册”模式：注册环信账号时，必须携带管理员身份认证信息。推荐使用“授权注册”，这样可以防止某些已经获取了注册 URL 和知晓注册流程的人恶意向服务器大量注册垃圾用户。
注意：以下 API 中提到的 ${token} 是个变量，使用时需要替换成通过 APP 的 client_id 和 client_secret 获取到的 token。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users
HTTP Method: POST
URL Params: 无
Request Headers: {“Content-Type”:”application/json”}
Request Body: {“username”:”${用户名}”,”password”:”${密码}”, “nickname”:”${昵称值}”}
注：创建用户时，username 和 password 是必须的，nickname 是可选的，这个 nickname 用于 iOS 推送。如果要在创建用户时设置 nickname，请求 body 是：{“username”:”jliu”,”password”:”123456”, “nickname”:”建国”} 这种形式，下面的示例不包含 nickname。批量注册时同此理。
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：400（用户已存在、用户名或密码为空、用户名不合法[见用户名规则]）、5xx。详见：
curl 示例：
curl -X POST -i &/easemob-demo/chatdemoui/users& -d '{&username&:&jliu&,&password&:&123456&}'
Response 示例：
&action& : &post&,
&application& : &a2e433a0-ab1a-11e2-a134-85fca932f094&,
&params& : { },
&path& : &/users&,
&uri& : &/easemob-demo/chatdemoui/users&,
&entities& : [ {
&uuid& : &7f90f7ca-bb24-11e2-b2d0-6d8e&,
&type& : &user&,
&created& : 6,
&modified& : 6,
&username& : &jliu&,
&activated& : true
&timestamp& : 3,
&duration& : 125,
&organization& : &easemob-demo&,
&applicationName& : &chatdemo&
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users
HTTP Method: POST
URL Params: 无
Request Headers: {“Content-Type”:”application/json”,”Authorization”:”Bearer ${token}”}
Request Body: {“username”:”${用户名}”,”password”:”${密码}”}
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：400（用户已存在、用户名或密码为空、用户名不合法[见用户名规则]）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X POST -H &Authorization: Bearer YWMt39RfMMOqEeKYE_GW7tu81AAAAT71lGijyjG4VUIC2AwZGzUjVbPp_4qRD5k& -i
&/easemob-demo/chatdemoui/users& -d '{&username&:&jliu&,&password&:&123456&}'
Response 示例：
&action& : &post&,
&application& : &a2e433a0-ab1a-11e2-a134-85fca932f094&,
&params& : { },
&path& : &/users&,
&uri& : &/easemob-demo/chatdemoui/users&,
&entities& : [ {
&uuid& : &7f90f7ca-bb24-11e2-b2d0-6d8e&,
&type& : &user&,
&created& : 6,
&modified& : 6,
&username& : &jliu&,
&activated& : true
&timestamp& : 3,
&duration& : 125,
&organization& : &easemob-demo&,
&applicationName& : &chatdemo&
注册 IM 用户[批量]
批量注册的用户数量不要过多，建议在20-60之间。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。请求体如果超过5kb会导致413错误，需要拆成几个更小的请求体重试。
Path: /{org_name}/{app_name}/users
HTTP Method: POST
URL Params: 无
Request Headers: {“Content-Type”:”application/json”,”Authorization”:”Bearer ${token}”}
Request Body: [{“username”:”${用户名1}”,”password”:”${密码}”},…,{“username”:”${用户名2}”,”password”:”${密码}”}]
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：400（用户已存在、用户名或密码为空、用户名不合法[见用户名规则]）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X POST -H &Authorization: Bearer YWMtP_8IisA-EeK-a5cNq4Jt3QAAAT7fI10IbPuKdRxUTjA9CNiZMnQIgk0LEUE& -i
&/easemob-demo/chatdemoui/users& -d '[{&username&:&u1&, &password&:&p1&}, {&username&:&u2&, &password&:&p2&}]'
Response 示例：
&action& : &post&,
&application& : &4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5&,
&params& : { },
&path& : &/users&,
&uri& : &/easemob-demo/chatdemoui/users&,
&entities& : [ {
&uuid& : &de73238a-31ca-11e4-bdc9-9fdda213fcaa&,
&type& : &user&,
&created& : 0,
&modified& : 0,
&username& : &u1&,
&activated& : true
&uuid& : &de86365a-31ca-11e4-aecf-d6&,
&type& : &user&,
&created& : 5,
&modified& : 5,
&username& : &u2&,
&activated& : true
&timestamp& : 2,
&duration& : 802,
&organization& : &easemob-demo&,
&applicationName& : &chatdemoui&
获取 IM 用户[单个]
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users/{username}
HTTP Method: GET
URL Params: 无
Request Headers: {“Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：404（用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X GET -H &Authorization: Bearer YWMtSozP9jHNEeSQegV9EK5eAQAAAUlmBR2bTGr-GP2xNh8GhUCdKViBFgtox3M& -i
&/easemob-demo/chatdemoui/users/ywuxvxuir6&
Response 示例：
&action& : &get&,
&application& : &4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5&,
&params& : { },
&path& : &/users&,
&uri& : &/easemob-demo/chatdemoui/users/ywuxvxuir6&,
&entities& : [ {
&uuid& : &628a88ba-dfce-11e3-8cac-51d3cb69b303&,
&type& : &user&,
&created& : 5,
&modified& : 5,
&username& : &ywuxvxuir6&,
&activated& : true
&timestamp& : 7,
&duration& : 57,
&organization& : &easemob-demo&,
&applicationName& : &chatdemoui&
获取 IM 用户[批量]
该接口默认返回最早创建的10个用户，如果需要指定获取数量，需加上参数 limit=N，N 为数量值。关于分页：如果 DB 中的数量大于 N，返回 JSON 会携带一个字段“cursor”,我们把它叫做”游标”，该游标可理解为结果集的指针，值是变化的。往下取数据的时候带着游标，就可以获取到下一页的值。如果还有下一页，返回值里依然还有这个字段，直到没有这个字段，说明已经到最后一页。cursor的意义在于数据（真）分页。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users
HTTP Method: GET
URL Params: limit=20
Request Headers: {“Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：404（用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X GET -H &Authorization: Bearer YWMtP_8IisA-EeK-a5cNq4Jt3QAAAT7fI10IbPuKdRxUTjA9CNiZMnQIgk0LEUE& -i
&/easemob-demo/chatdemoui/users?limit=20&
Response 示例：
&action& : &get&,
&application& : &4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5&,
&params& : {
&limit& : [ &20& ]
&path& : &/users&,
&uri& : &/easemob-demo/chatdemoui/users?ql=select+*+from+null&limit=20&,
&entities& : [ {
&uuid& : &fff15c10-df37-11e3-843f-e5b88d483c56&,
&type& : &user&,
&created& : 4,
&modified& : 6,
&username& : &wjglpgecxu&,
&activated& : true,
&nickname& : &wjglpgecxu&,
&notifier_name& : &chatdemoui_dev&
&uuid& : &4cca8760-df3c-11e3-3b2df95&,
&type& : &user&,
&created& : 1,
&modified& : 1,
&username& : &pfs5afofrf&,
&activated& : true
&uuid& : &5918fb7a-df3f-11e3-94d1-1f977e72d55c&,
&type& : &user&,
&created& : 9,
&modified& : 0,
&username& : &igm8dl8m2e&,
&activated& : true,
&nickname& : &sadsadsa&,
&notification_display_style& : 0,
&notification_no_disturbing& : false
&uuid& : &ee6e5a3a-df3f-11e3-bbe9-d3aa&,
&type& : &user&,
&created& : 9,
&modified& : 9,
&username& : &lgqieuevag&,
&activated& : true
&uuid& : &6d3ba2ea-df41-11e3-b304-eb2e9192a84a&,
&type& : &user&,
&created& : 4,
&modified& : 4,
&username& : &quqx6qjmb2&,
&activated& : true
&uuid& : &51b663ba-df42-11e3-8470-cd&,
&type& : &user&,
&created& : 9,
&modified& : 9,
&username& : &y0fchl0ps9&,
&activated& : true
&uuid& : &b8b1c32a-df42-11e3-b375-5&,
&type& : &user&,
&created& : 4,
&modified& : 4,
&username& : &v3y0kf9arx&,
&activated& : true
&uuid& : &8cf86e4a-df61-11e3-8a70-25cc7e73257e&,
&type& : &user&,
&created& : 6,
&modified& : 6,
&username& : &kapzkr9rro&,
&activated& : true
&uuid& : &a11dca4a-df62-11e3-bea6a0997&,
&type& : &user&,
&created& : 2,
&modified& : 2,
&username& : &vkpvscnkzn&,
&activated& : true
&uuid& : &-df64-11e3-aaae-6bc8d50bc307&,
&type& : &user&,
&created& : 1,
&modified& : 1,
&username& : &6tkecmjtzn&,
&activated& : true
&uuid& : &1ed6bffa-df68-11e3-80f0-33f&,
&type& : &user&,
&created& : 3,
&modified& : 3,
&username& : &xc6xrnbzci&,
&activated& : true
&uuid& : &5472a84a-df68-11e3-b0b9-735c1b1db9a1&,
&type& : &user&,
&created& : 4,
&modified& : 4,
&username& : &vrhfk5lxsz&,
&activated& : true
&uuid& : &79b3db1a-dfbd-11e3-9c5d-3be5e57070a5&,
&type& : &user&,
&created& : 9,
&modified& : 9,
&username& : &qmlu5szkbm&,
&activated& : true
&uuid& : &3a2416ea-dfc2-11e3-a3e8-238b964488ee&,
&type& : &user&,
&created& : 4,
&modified& : 4,
&username& : &6pxxbfcnxu&,
&activated& : true
&uuid& : &65f6cf1a-dfc2-11e3-9dad-b97&,
&type& : &user&,
&created& : 7,
&modified& : 7,
&username& : &xffslraxae&,
&activated& : true
&uuid& : &2631911a-dfc9-11e3-803d-23343cadc4ed&,
&type& : &user&,
&created& : 5,
&modified& : 5,
&username& : &pfxfc9ggkz&,
&activated& : true
&uuid& : &4295acaa-dfca-11e3-9bf1-5fd8df7f7659&,
&type& : &user&,
&created& : 4,
&modified& : 4,
&username& : &pksaxc6pao&,
&activated& : true
&uuid& : &8c76072a-dfca-11e3-acc7-7dbd7c3dd494&,
&type& : &user&,
&created& : 8,
&modified& : 8,
&username& : &s1yqttgtya&,
&activated& : true
&uuid& : &93d710ea-dfca-11e3-a6e8-4f903c0b10fb&,
&type& : &user&,
&created& : 8,
&modified& : 8,
&username& : &qihp1et8t4&,
&activated& : true
&uuid& : &b1fbbdaa-dfca-11e3-a242-8db&,
&type& : &user&,
&created& : 0,
&modified& : 0,
&username& : &0vwy72min6&,
&activated& : true
&timestamp& : 8,
&duration& : 747,
&organization& : &easemob-demo&,
&applicationName& : &chatdemoui&,
&cursor& : &LTU2ODc0MzQzOnNmdTlxdF9LRWVPaVFvMWlBZmc4S3c&,
&count& : 20
Path: /{org_name}/{app_name}/users
HTTP Method: GET
URL Params: limit=20&cursor=LTU2ODc0MzQzOnNmdTlxdF9LRWVPaVFvMWlBZmc4S3c
Request Headers: {“Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
curl 示例：
curl -X GET -H &Authorization: Bearer YWMtSozP9jHNEeSQegV9EKeAQAAAUlmBR2bTGr-GP2xNh8GhUCdKViBFgtox3M& -i
&/easemob-demo/chatdemoui/users?limit=20&cursor=LTU2ODc0MzQzOnNmdTlxdF9LRWVPaVFvMWlBZmc4S3c&
Response 示例：
&action& : &get&,
&application& : &4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5&,
&params& : {
&limit& : [ &20& ],
&cursor& : [ &LTU2ODc0MzQzOnNmdTlxdF9LRWVPaVFvMWlBZmc4S3c& ]
&path& : &/users&,
&uri& : &/easemob-demo/chatdemoui/users?ql=select+*+from+null&limit=20&,
&entities& : [ {
&uuid& : &db8b63aa-dfca-11e3-b938-24&,
&type& : &user&,
&created& : 8,
&modified& : 8,
&username& : &an9hmj9js2&,
&activated& : true
&uuid& : &e4fab3fa-dfca-11e3-a4ce-c8&,
&type& : &user&,
&created& : 7,
&modified& : 7,
&username& : &3qwepp6xkg&,
&activated& : true
&uuid& : &f844e7aa-dfca-11e3-9eb4-3d526f9ecfeb&,
&type& : &user&,
&created& : 0,
&modified& : 0,
&username& : &ce41dtafer&,
&activated& : true
&uuid& : &fc4f4c5a-dfca-11e3-aaf8-239a98c53960&,
&type& : &user&,
&created& : 9,
&modified& : 9,
&username& : &2ewcgkhhxf&,
&activated& : true
&uuid& : &0005ebba-dfcb-11e3-eb21dbc4&,
&type& : &user&,
&created& : 9,
&modified& : 9,
&username& : &zh9w1hc49q&,
&activated& : true
&uuid& : &7f8e638a-dfcb-11e3-971e-fdc9e466fac1&,
&type& : &user&,
&created& : 4,
&modified& : 4,
&username& : &lxrpebngsl&,
&activated& : true
&uuid& : &2d7fa7ba-dfcc-11e3-8b04-5f7a1794920c&,
&type& : &user&,
&created& : 1,
&modified& : 1,
&username& : &yeimn3szbh&,
&activated& : true
&uuid& : &3cc89e7a-dfcc-11e3-9a11-f1c6519f66af&,
&type& : &user&,
&created& : 5,
&modified& : 5,
&username& : &7s5e3jtieh&,
&activated& : true
&uuid& : &7cc785ea-dfcc-11e3-b24a-d5b&,
&type& : &user&,
&created& : 2,
&modified& : 2,
&username& : &5cxhactgdj&,
&activated& : true
&uuid& : &ba8b717a-dfcc-11e3-85ca-3db38b18c75d&,
&type& : &user&,
&created& : 7,
&modified& : 7,
&username& : &qjf8b3r6q8&,
&activated& : true
&uuid& : &d5ad176a-dfcc-11e3-9e67-d933f3e27add&,
&type& : &user&,
&created& : 6,
&modified& : 6,
&username& : &mh2kbjyop1&,
&activated& : true
&uuid& : &2d4bf81a-dfcd-11e3-9e57-eb0fac2d4582&,
&type& : &user&,
&created& : 9,
&modified& : 9,
&username& : &q4xpsfjfvf&,
&activated& : true
&uuid& : &65368b5a-dfcd-11e3-8a1a-b9f751cf717c&,
&type& : &user&,
&created& : 1,
&modified& : 1,
&username& : &r1xnbh79us&,
&activated& : true
&uuid& : &6a9423fa-dfcd-11e3-a8c96d7d&,
&type& : &user&,
&created& : 3,
&modified& : 3,
&username& : &sofa8kyoca&,
&activated& : true
&uuid& : &1698653a-dfce-11e3-0b7ce4&,
&type& : &user&,
&created& : 9,
&modified& : 9,
&username& : &4lo3srucvl&,
&activated& : true
&uuid& : &236b79fa-dfce-11e3-a9a3-250f2047b4bc&,
&type& : &user&,
&created& : 5,
&modified& : 5,
&username& : &w2k0etnjjj&,
&activated& : true
&uuid& : &54eb716a-dfce-11e3-9781-ab&,
&type& : &user&,
&created& : 2,
&modified& : 2,
&username& : &ir4ad2dqri&,
&activated& : true
&uuid& : &5bb51d2a-dfce-11e3-be10-4ff224c17422&,
&type& : &user&,
&created& : 0,
&modified& : 0,
&username& : &0fktzcr36b&,
&activated& : true
&uuid& : &60cf6b3a-dfce-11e3-b8bf-ed78a8f851f8&,
&type& : &user&,
&created& : 1,
&modified& : 1,
&username& : &ytbdzt3w9e&,
&activated& : true
&uuid& : &628a88ba-dfce-11e3-8cac-51d3cb69b303&,
&type& : &user&,
&created& : 5,
&modified& : 5,
&username& : &ywuxvxuir6&,
&activated& : true
&timestamp& : 5,
&duration& : 2812,
&organization& : &easemob-demo&,
&applicationName& : &chatdemoui&,
&cursor& : &LTU2ODc0MzQzOllvcUl1dF9PRWVPTXJGSFR5Mm16QXc&,
&count& : 20
删除 IM 用户[单个]
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
注意：删除一个用户会删除以该用户为群主的所有群组和聊天室。
Path: /{org_name}/{app_name}/users/{username}
HTTP Method: DELETE
URL Params: 无
Request Headers: {“Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：404（用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X DELETE -H &Authorization: Bearer YWMtSozP9jHNEeSQegV9EK5eAQAAAUlmBR2bTGr-GP2xNh8GhUCdKViBFgtox3M& -i
&/easemob-demo/chatdemoui/users/ywuxvxuir6&
Response 示例：
&action& : &delete&,
&application& : &4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5&,
&params& : { },
&path& : &/users&,
&uri& : &/easemob-demo/chatdemoui/users&,
&entities& : [ {
&uuid& : &628a88ba-dfce-11e3-8cac-51d3cb69b303&,
&type& : &user&,
&created& : 5,
&modified& : 5,
&username& : &ywuxvxuir6&,
&activated& : true
&timestamp& : 0,
&duration& : 3330,
&organization& : &easemob-demo&,
&applicationName& : &chatdemoui&
删除 IM 用户[批量]
删除某个 APP 下指定数量的环信账号。可一次删除 N 个用户，数值可以修改。建议这个数值在100-500之间，不要过大。需要注意的是，这里只是批量的一次性删除掉 N个用户，具体删除哪些并没有指定，可以在返回值中查看到哪些用户被删除掉了。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users
HTTP Method: DELETE
URL Params: limit=N，N指定删除数据的最大条数
Request Headers: {“Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：404（用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X DELETE -H &Authorization: Bearer YWMtSozP9jHNEeSQegV9EK5eAQAAAUlmBR2bTGr-GP2xNh8GhUCdKViBFgtox3M& -i
&/easemob-demo/chatdemoui/users?limit=5&
Response 示例：
&action& : &delete&,
&application& : &4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5&,
&params& : {
&limit& : [ &5& ]
&path& : &/users&,
&uri& : &/easemob-demo/chatdemoui/users&,
&entities& : [ {
&uuid& : &fff15c10-df37-11e3-843f-e5b88d483c56&,
&type& : &user&,
&created& : 4,
&modified& : 6,
&username& : &wjglpgecxu&,
&activated& : true,
&nickname& : &wjglpgecxu&,
&notifier_name& : &chatdemoui_dev&
&uuid& : &4cca8760-df3c-11e3-3b2df95&,
&type& : &user&,
&created& : 1,
&modified& : 1,
&username& : &pfs5afofrf&,
&activated& : true
&uuid& : &5918fb7a-df3f-11e3-94d1-1f977e72d55c&,
&type& : &user&,
&created& : 9,
&modified& : 0,
&username& : &igm8dl8m2e&,
&activated& : true,
&nickname& : &sadsadsa&,
&notification_display_style& : 0,
&notification_no_disturbing& : false
&uuid& : &ee6e5a3a-df3f-11e3-bbe9-d3aa&,
&type& : &user&,
&created& : 9,
&modified& : 9,
&username& : &lgqieuevag&,
&activated& : true
&uuid& : &6d3ba2ea-df41-11e3-b304-eb2e9192a84a&,
&type& : &user&,
&created& : 4,
&modified& : 4,
&username& : &quqx6qjmb2&,
&activated& : true
&timestamp& : 5,
&duration& : 9426,
&organization& : &easemob-demo&,
&applicationName& : &chatdemoui&,
&cursor& : &LTU2ODc0MzQzOmJUdWk2dDlCRWVPekJPc3VrWktvU2c&
重置 IM 用户密码
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users/{username}/password
HTTP Method: PUT
URL Params: 无
Request Headers: {“Authorization”:”Bearer ${token}”}
Request Body: {“newpassword” : “${新密码指定的字符串}”}
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：404（用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X PUT -H &Authorization: Bearer YWMtSozP9jHNEeSQegV9EKeAQAAAUlmBR2bTGr-GP2xNh8GhUCdKViBFgtox3M& -i
&/easemob-demo/chatdemoui/users/ywuxvxuir6/password& -d '{&newpassword& : &123456&}'
Response 示例：
&action& : &set user password&,
&timestamp& : 4,
&duration& : 326
修改用户昵称
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users/{username}
HTTP Method: PUT
URL Params: 无
Request Headers: {“Authorization”:”Bearer ${token}”}
Request Body: {“nickname” : “${昵称值}”}
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：404（用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X PUT -H &Authorization: Bearer YWMtSozP9jHNEeSQegV9EKeAQAAAUlmBR2bTGr-GP2xNh8GhUCdKViBFDSEF2E& -i
&/easemob-demo/chatdemoui/users/jianguo& -d '{&nickname& : &张建国&}'
Response 示例：
&action& : &put&,
&application& : &4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5&,
&path& : &/users&,
&uri& : &/easemob-demo/chatdemoui/users&,
&entities& : [ {
&uuid& : &c3b56d5a--92d2-edab82ae2302&,
&type& : &user&,
&created& : 1,
&modified& : 7,
&username& : &jianguo&,
&activated& : true,
&device_token& : &e69cd1d62c5b390e42f4b1cd15bf1a876a487268cfaef9960188ee&,
&nickname& : &张建国&
&timestamp& : 5,
&duration& : 278,
&organization& : &easemob-demo&,
&applicationName& : &chatdemoui&
好友与黑名单
给 IM 用户添加好友
给一个用户添加好友，好友必须是和自己在一个 APP 下的 IM 用户。{owner_username} 是要添加好友的用户名，{friend_username} 是被添加的用户名。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users/{owner_username}/contacts/users/{friend_username}
HTTP Method: POST
URL Params: 无
Request Headers: {“Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：404（此IM用户或被添加的好友不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X POST -H &Authorization: Bearer YWMtP_8IisA-EeK-a5cNq4Jt3QAAAT7fI10IbPuKdRxUTjA9CNiZMnQIgk0LEU2& -i
&/easemob-demo/chatdemoui/users/jliu/contacts/users/yantao&
Response 示例：
&action&:&post&,&application&:&4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5&,&params&:{},
&path&:&/users/aa6160da-eb01-11e3-ab09-15edd986e7b7/contacts&,
&uri&:&/easemob-demo/chatdemoui/users/jliu/contacts/yantao&,
&entities&:[
&uuid&:&0086742a-dc9b-11e3-a782-1b5d581c57a9&,
&type&:&user&,
&created&:0,
&modified&:0,
&username&:&yantao&,
&activated&:true
&timestamp&:4,&duration&:242,
&organization&:&easemob-demo&,
&applicationName&:&chatdemoui&
解除 IM 用户的好友关系
从 IM 用户的好友列表中移除一个用户。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users/{owner_username}/contacts/users/{friend_username}
HTTP Method: DELETE
URL Params: 无
Request Headers: {“Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：404（此 IM 用户或被解除的好友不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X DELETE -i -H &Authorization: Bearer YWMtP_8IisA-EeK-a5cNq4Jt3QAAAT7fI10IbPuKdRxUTjA9CNiZMnQIgk0LEU2& &/easemob-demo/chatdemoui/users/stliu/contacts/users/yantao&
Response 示例：
&action& : &delete&,
&application& : &4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5&,
&params& : { },
&path& : &/users/stliu/contacts&,
&uri& : &/easemob-demo/chatdemoui/users/stliu/contacts/users/yantao&,
&entities& : [ {
&uuid& : &aa6160da-eb01-11e3-ab09-15edd986e7b7&,
&type& : &user&,
&created& : 5,
&modified& : 5,
&username& : &88888&,
&activated& : true,
&device_token& : &67aab3a88a0b146b5ffe94f509a4e69e8b1db503b2fa4f9c556dd3&,
&nickname& : &88888&,
&notification_display_style& : 0,
&notification_no_disturbing& : false,
&notification_no_disturbing_end& : 24,
&notification_no_disturbing_start& : 0,
&notifier_name& : &chatdemoui_dev&
&timestamp& : 8,
&duration& : 1575,
&organization& : &easemob-demo&,
&applicationName& : &chatdemoui&
查看某个 IM 用户的好友信息。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users/{owner_username}/contacts/users
HTTP Method: GET
URL Params: 无
Request Headers: {“Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：404（此 IM 用户或要查看的好友不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X GET -H &Authorization: Bearer YWMtP_8IisA-EeK-a5cNq4Jt3QAAAT7fI10IbPuKdRxUTjA9CNiZMnQIgk0LEU2& -i
&/easemob-demo/chatdemoui/users/v3y0kf9arx/contacts/users&
Response 示例：
&action& : &get&,
&application& : &4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5&,
&params& : { },
&uri& : &/easemob-demo/chatdemoui/users/v3y0kf9arx/contacts/users&,
&entities& : [ ],
&data& : [ &88888& ],
&timestamp& : 1,
&duration& : 45,
&organization& : &easemob-demo&,
&applicationName& : &chatdemoui&
获取 IM 用户的黑名单
获取一个IM用户的黑名单。黑名单中的用户无法给该 IM 用户发送消息。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users/{owner_username}/blocks/users
HTTP Method: GET
URL Params: 无
Request Headers: {“Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: “data” : [ “stliu2” ] — 黑名单中的用户的用户名：stliu2
可能的错误码：404（此 IM 用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X GET -H &Authorization: Bearer YWMtwIRGSE9gEeSbpNnVBsIhiwAAAUon2XDyEBoBUk6Vg2xm8DZdVjxbhwm7XWY& -i
&/easemob-demo/chatdemoui/users/v3y0kf9arx/blocks/users&
Response 示例：
&action& : &get&,
&uri& : &/easemob-demo/chatdemoui/users/v3y0kf9arx/blocks/users&,
&entities& : [ ],
&data& : [ &stliu2& ],
&timestamp& : 3,
&duration& : 36
往 IM 用户的黑名单中加人
往一个 IM 用户的黑名单中加人，一次可以添加一个或多个。黑名单中的用户无法给该 IM 用户发送消息。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users/{owner_username}/blocks/users
HTTP Method: POST
URL Params: 无
Request Headers: {“Authorization”:”Bearer ${token}”}
Request Body: {“usernames”:[“5cxhactgdj”, “mh2kbjyop1”]} —- 需要加入到黑名单中的用户名以数组方式提交，usernames 为关键字不变
Response Body: “data” : [ “5cxhactgdj”, “mh2kbjyop1” ] — 已经加到黑名单中的用户名：5cxhactgdj、mh2kbjyop1
可能的错误码：404（此 IM 用户或被添加的用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X POST -H 'Authorization: Bearer YWMtwIRGSE9gEeSbpNnVBsIhiwAAAUon2XDyEBoBUk6Vg2xm8DZdVjxbhwm7XWY' -i
'/easemob-demo/chatdemoui/users/v3y0kf9arx/blocks/users' -d '{&usernames&:[&5cxhactgdj&, &mh2kbjyop1&]}'
Response 示例：
&action& : &post&,
&application& : &4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5&,
&uri& : &/easemob-demo/chatdemoui&,
&entities& : [ ],
&data& : [ &5cxhactgdj&, &mh2kbjyop1& ],
&timestamp& : 2,
&duration& : 15,
&organization& : &easemob-demo&,
&applicationName& : &chatdemoui&
从 IM 用户的黑名单中减人
从一个 IM 用户的黑名单中减人。将用户从黑名单移除后，恢复好友关系，可以互相收发消息。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users/{owner_username}/blocks/users/{blocked_username}
HTTP Method: DELETE
URL Params: 无
Request Headers: {“Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: entities 中包含了刚刚从黑名单中移除的 IM 用户的详细信息
可能的错误码：404（此 IM 用户或被减的用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X DELETE -H 'Authorization: Bearer YWMtwIRGSE9gEeSbpNnVBsIhiwAAAUon2XDyEBoBUk6Vg2xm8DZdVjxbhwm7XWY' -i
'/easemob-demo/chatdemoui/users/v3y0kf9arx/blocks/users/5cxhactgdj'
Response 示例：
&action& : &delete&,
&application& : &4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5&,
&path& : &/users/72bb4f9a-fce7-11e3-98f4-adc39e9f4363/blocks&,
&uri& : &/easemob-demo/chatdemoui/users/v3y0kf9arx/blocks&,
&entities& : [ {
&uuid& : &7cc785ea-dfcc-11e3-b24a-d5b&,
&type& : &user&,
&created& : 2,
&modified& : 2,
&username& : &5cxhactgdj&,
&activated& : true
&timestamp& : 0,
&duration& : 164,
&organization& : &easemob-demo&,
&applicationName& : &chatdemoui&
在线与离线
查看用户在线状态
查看一个用户的在线状态。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users/{username}/status
HTTP Method: GET
URL Params: 无
Request Headers: {“Content-Type”:”application/json”,”Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：404（此用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X GET -i -H &Authorization: Bearer YWMtxc6K0L1aEeKf9LWFzT9xEAAAAT7MNR_9OcNq-GwPsKwj_TruuxZfFSC2eIQ& &/easemob-demo/chatdemoui/users/zw123/status&
Response 示例：
&action&: &get&,
&application&: &4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5&,
&params&: {},
&uri&: &/easemob-demo/chatdemoui&,
&entities&: [],
&stliu&: &online&
//注意：这里返回的是用户名和在线状态的键值对，值为 online 或者 offline
&timestamp&: 0,
&duration&: 743,
&organization&: &easemob-demo&,
&applicationName&: &chatdemoui&
查询离线消息数
获取一个 IM 用户的离线消息数。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users/{owner_username}/offline_msg_count
HTTP Method: GET
URL Params: 无
Request Headers: {“Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: “data” : {“v3y0kf9arx” : 0 } —- 用户名：v3y0kf9arx，离线消息数：0条
可能的错误码：404（此用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X GET -H &Authorization: Bearer YWMtwIRGSE9gEeSbpNnVBsIhiwAAAUon2XDyEBoBUk6Vg2xm8DZdVjxbhwm7XWY& -i
&/easemob-demo/chatdemoui/users/v3y0kf9arx/offline_msg_count&
Response 示例：
&action& : &get&,
&uri& : &/easemob-demo/chatdemoui/users/v3y0kf9arx/offline_msg_count&,
&entities& : [ ],
&data& : {
&v3y0kf9arx& : 0
&timestamp& : 4,
&duration& : 57
查询某条离线消息状态
通过离线消息的 ID 查看用户的该条离线消息状态。消息ID可以通过查询。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users/{username}/offline_msg_status/{msg_id}
HTTP Method: GET
URL Params: 无
Request Headers: {“Content-Type”:”application/json”,”Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：404（此用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X GET -i -H &Authorization: Bearer YWMtxc6K0L1aEeKf9LWFzT9xEAAAAT7MNR_9OcNq-GwPsKwj_TruuxZfFSC2eIQ& &/easemob-demo/chatdemoui/users/zw123/offline_msg_status/1121212&
Response 示例：
&action&: &get&,
&uri&: &/easemob-demo/chatdemoui/users/jianxin/offline_msg_status/12&,
&entities&: [],
&12&: &delivered&
// 格式：&{消息id}&:&{状态}&，状态的值有两个: deliverd表示此用户的该条离线消息已经收到过了，undelivered表示此用户的该条离线消息还未收到
&timestamp&: 2,
&duration&: 644
账号禁用与解禁
用户账号禁用
禁用某个 IM 用户的账号，禁用后该用户不可登录，下次解禁后该账户恢复正常使用。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users/{username}/deactivate
HTTP Method: POST
URL Params: 无
Request Headers: {“Content-Type”:”application/json”,”Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：404（此用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X POST -i -H &Authorization: Bearer YWMtxc6K0L1aEeKf9LWFzT9xEAAAAT7MNR_9OcNq-GwPsKwj_TruuxZfFSC2eIQ& &/easemob-demo/chatdemoui/users/zw123/deactivate&
Response 示例：
&action&: &Deactivate user&,
&entities&: [
&uuid&: &e5-11e4-b1d3-b70cde5a834c&,
&type&: &user&,
&created&: 7,
&modified&: 3,
&username&: &zw123&,
&activated&: false,
&nickname&: &zw123&
&timestamp&: 9,
&duration&: 244
用户账号解禁
解除对某个 IM 用户账号的禁用，解禁后用户恢复正常使用。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users/{username}/activate
HTTP Method: POST
URL Params: 无
Request Headers: {“Content-Type”:”application/json”,”Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：404（此用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X POST -i -H &Authorization: Bearer YWMtxc6K0L1aEeKf9LWFzT9xEAAAAT7MNR_9OcNq-GwPsKwj_TruuxZfFSC2eIQ& &/easemob-demo/chatdemoui/users/zw123/activate&
Response 示例：
&action&: &activate user&,
&timestamp&: 5,
&duration&: 2
强制用户下线
如果某个 IM 用户已经登录环信服务器，强制其退出登录。
接口限流说明：同一个 APP 每秒最多可调用30次，超过的部分会返回429或503错误。所以在调用程序中，如果碰到了这样的错误，需要稍微暂停一下并且重试。如果该限流控制不满足需求，请联系商务经理开放更高的权限。
Path: /{org_name}/{app_name}/users/{username}/disconnect
HTTP Method: GET
URL Params: 无
Request Headers: {“Content-Type”:”application/json”,”Authorization”:”Bearer ${token}”}
Request Body: 无
Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
可能的错误码：404（此用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：
curl 示例：
curl -X GET -i -H &Authorization: Bearer YWMtxc6K0L1aEeKf9LWFzT9xEAAAAT7MNR_9Ocqq-GwPsKwj_TruuxZfFSC2eIQ& &/easemob-demo/chatdemoui/users/zw123/disconnect&
Response 示例：
&action& : &Disconnect user&,
&data& : {
&result& : true
// true表示强制下线成功，false表示强制用户下线失败
&timestamp& : 9,
&duration& : 16