环信IM即时通讯（服务端） - 群组管理

IM即时通讯

简介/价格/文档

文档简介：

环信即时通讯 IM 提供了 RESTful API 管理 App 中的群组。单个 App 创建群组数量有限制，而且单个用户可加入群组的数量视版本而定，详见使用限制。前提条件：要调用环信即时通讯 RESTful API，请确保满足以下要求：已在环信即时通讯 IM 管理后台开通配置环信即时通讯 IM 服务。了解环信 IM RESTful API 的调用频率限制，详见接口频率限制。

*此产品及展示信息均由环信官方提供。免费试用咨询热线：400-826-7010，为您提供专业的售前咨询，让您快速了解云产品，助您轻松上云！微信咨询

免费试用、价格特惠

文档详情

环信即时通讯 IM 提供了 RESTful API 管理 App 中的群组。

单个 App 创建群组数量有限制，而且单个用户可加入群组的数量视版本而定，详见使用限制。

#前提条件

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

已在环信即时通讯 IM 管理后台开通配置环信即时通讯 IM 服务。
了解环信 IM RESTful API 的调用频率限制，详见接口频率限制。

#公共参数

#请求参数

参数	类型	是否必需	描述
host	String	是	环信即时通讯 IM 分配的用于访问 RESTful API 的域名。详见获取环信即时通讯 IM 的信息。
org_name	String	是	环信即时通讯 IM 为每个公司（组织）分配的唯一标识。详见获取环信即时通讯 IM 的信息。
app_name	String	是	你在环信即时通讯云控制台创建应用时填入的应用名称。详见获取环信即时通讯 IM 的信息。
group_id	String	是	群组 ID。
username	String	是	用户 ID。

#响应参数

参数	类型	描述
action	String	请求方法。
organization	String	环信即时通讯 IM 为每个公司（组织）分配的唯一标识，与请求参数 org_name 相同。
application	String	应用在系统内的唯一标识。该标识由系统生成，开发者无需关心。
applicationName	String	你在环信即时通讯云控制台创建应用时填入的应用名称，与请求参数 app_name 相同。
uri	String	请求 URL。
path	String	请求路径，属于请求 URL 的一部分，开发者无需关注。
entities	JSON	响应实体。
data	JSON	实际获取的数据详情。
uuid	String	用户在系统内的唯一标识。该标识由系统生成，开发者无需关心。
created	Long	群组创建时间，Unix 时间戳，单位为毫秒。
timestamp	Long	Unix 时间戳，单位为毫秒。
duration	Int	从发送请求到响应的时长，单位为毫秒。
properties	String	响应属性。

#群组角色

群组角色包含群主、群管理员和普通群成员，三个角色权限范围依次递减。

群主拥有群的所有权限；
群管理员拥有管理黑名单、白名单和禁言等权限；
群主加管理员数量共 100 个，即管理员最多可添加 99 个。

#认证方式

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

Authorization: Bearer YourAppToken

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

#创建和管理群组

#创建群组

创建一个群组，并设置群组名称、群组描述、公开群/私有群属性、群成员最大人数（包括群主）、加入公开群是否需要批准、群主、群成员和群组扩展信息。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/chatgroups

#路径参数

参数及描述详见公共参数。

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#请求 body

参数	类型	是否必需	描述
groupname	String	是	群组名称，最大长度为 128 字符。如果有空格，则使用 “+” 代替。
description	String	是	群组描述，最大长度为 512 字符。如果有空格，则使用 “+” 代替。
public	Bool	是	是否是公开群。公开群可以被搜索到，用户可以申请加入公开群；私有群无法被搜索到，因此需要群主或群管理员添加，用户才可以加入。 - true：公开群； - false：私有群。
maxusers	Int	否	群组最大成员数（包括群主），值为数值类型，默认值 200。不同套餐支持的人数上限不同，详见产品价格open in new window。
allowinvites	Bool	是	是否允许群成员邀请用户加入群组： - true：群成员可拉人入群; - （默认）false：只有群主或者管理员才可以拉人入群。注：该参数仅对私有群有效，因为公开群不允许群成员邀请其他用户入群。
membersonly	Bool	否	用户申请入群是否需要群主或者群管理员审批。 - true：需要； - （默认）false：不需要，用户直接进群。
invite_need_confirm	Bool	否	邀请用户入群时是否需要被邀用户同意。 - （默认）true：是； - false：否。
owner	String	是	群组的管理员。
members	Array	否	群组成员的用户 ID 数组。该数组可包含 1-100 个元素，不包含群主的用户 ID。
custom	String	否	群组扩展信息，例如可以给群组添加业务相关的标记，不要超过 1,024 字符。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.groupid	String	群组 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST -H 'Content-Type: application/json'

-H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>' -d '{
   "groupname": "testgroup",
   "description": "test",
   "public": true,
   "maxusers": 300,
   "owner": "testuser",
   "members": [
     "user2"
   ]
 }' 'https://XXXX/XXXX/XXXX/chatgroups'

#响应示例

{ "action": "post", "application": "8bXXXX02", "uri": "https://XXXX/XXXX/XXXX/chatgroups", "entities":

[], "data": { "groupid": "6XXXX7" }, "timestamp": 1542361730243, "duration": 0, "

organization": "XXXX", "applicationName": "testapp" }

#封禁群组

封禁指定的群组。例如，群成员经常在群中发送违规消息，可以调用该 API 对该群进行封禁。群组被封禁后，群中任何成员均无法在群组以及该群组下的子区中发送和接收消息，也无法进行群组和子区管理操作。

群组封禁后，可调用解禁群组 API 对该群组解禁。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/disable

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.disabled	Bool	群组是否为禁用状态： - true：群组被禁用； - false：群组为启用状态。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST -H 'Content-Type: application/json'

 -H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups/XXXX/disable'

#响应示例

{ "action": "post", "application": "XXXX", "applicationName": "XXXX", "data": { "disabled": true },

"duration": 740, "entities": [], "organization": "XXXX", "properties": {}, "timestamp": 1672974260359,

 "uri": "https://XXXX/XXXX/XXXX/chatgroups/XXXX/disable" }

#解禁群组

解除对指定群组的封禁。群组解禁后，群成员可以在该群组以及该群组下的子区中发送和接收消息并进行群组和子区管理相关操作。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/enable

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.disabled	Bool	群组是否为禁用状态： - true：群组被禁用； - false：群组为启用状态。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST -H 'Content-Type: application/json'

 -H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups/XXXX/enable'

#响应示例

{ "action": "post", "application": "XXXX", "applicationName": "XXXX", "data": { "disabled": false },

"duration": 22, "entities": [], "organization": "XXXX", "properties": {}, "timestamp": 1672974668171,

 "uri": "https://XXXX/XXXX/XXXX/chatgroups/XXXX/enable" }

#修改群组信息

修改指定的群组信息，可修改 groupname、description、maxusers、membersonly、allowinvites、invite_need_confirm、public 和 custom 属性。如果传入其他字段，或传入的字段不存在，则不能修改的字段会抛出异常。

#HTTP 请求

PUT https://{host}/{org_name}/{app_name}/chatgroups/{group_id}

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#请求 body

参数	类型	是否必需	描述
groupname	String	否	群组名称，修改时值不能包含斜杠（“/”），最大长度为 128 字符。如果有空格，则使用 “+” 代替。
description	String	否	群组描述，修改时值不能包含斜杠（“/”），最大长度为 512 字符。如果有空格，则使用 “+” 代替。
maxusers	Int	否	群组成员最大数（包括群主），值为数值类型。
membersonly	Bool	否	加入群组是否需要群主或者群管理员审批： - true：是； - false：否。
allowinvites	Bool	否	是否允许群成员邀请别人加入此群： - true：允许群成员邀请人加入此群； - false：只有群主或群管理员才可以邀请用户入群。
invite_need_confirm	Bool	否	受邀人加入群组前是否需接受入群邀请： - true：需受邀人确认入群邀请； - false：受邀人直接加入群组，无需确认入群邀请。
custom	String	否	群组扩展信息，例如可以给群组添加业务相关的标记，不要超过 1,024 字符。
public	Bool	是	是否是公开群。 - true：公开群； - false：私有群。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.description	Bool	群组描述是否修改成功： - true：修改成功； - false：修改失败。
data.maxusers	Bool	群组最大成员数是否修改成功： - true：修改成功； - false：修改失败。
data.groupname	Bool	群组名称是否修改成功： - true：修改成功； - false：修改失败。
data.membersonly	Bool	“加入群组是否需要群主或者群管理员审批”是否修改成功： - true：修改成功； - false：修改失败。
data.public	Bool	“是否是公开群”是否修改成功： - true：修改成功； - false：修改失败。
data.allowinvites	Bool	“是否允许群成员邀请其他用户入群”是否修改成功： -true：修改成功； - false：修改失败。
data.invite_need_confirm	Bool	“受邀人加入群组前是否需接受入群邀请”是否修改成功： - true：修改成功； - false：修改失败。
data.custom	String	群组扩展信息是否修改成功： -true：修改成功； - false：修改失败。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X PUT -H 'Accept: application/json' -H 'Auth

orization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups/6XXXX7' -d '{
    "groupname": "test groupname",
    "description": "updategroupinfo12311",
    "maxusers": 1500,
    "membersonly": true,
    "allowinvites": false,
    "invite_need_confirm": true,
    "custom":"abc",
    "public": true
}'

#响应示例

{ "action": "put", "application": "XXXXXX", "applicationName": "XXXX", "data": { "allowinvites": true,

"invite_need_confirm": true, "membersonly": true, "public": true, "custom": true, "description": true,

 "maxusers": true, "groupname": true }, "duration": 0, "entities": [], "organization": "XXXX",

"properties": {}, "timestamp": 1666062065529, "uri": "https://XXXX/XXXX/XXXX/chatgroups/6XXXX7" }

#获取 App 中的群组

分页获取应用下的群组的信息。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/chatgroups?limit={N}&cursor={cursor}

#路径参数

参数及描述详见公共参数。

#查询参数

参数	类型	是否必需	描述
limit	Int	否	每次期望返回的群组数量。取值范围为 [1,100]，默认值为 10。
cursor	String	否	数据查询的起始位置。

提示

若请求中均未设置 limit 和 cursor 参数，环信服务器按群组创建时间倒序返回前 10 个群组。

#请求 header

参数	类型	是否必需	描述
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.owner	String	群主的用户 ID。例如：{“owner”: “user1}。
data.groupid	String	群组 ID。
data.affiliations	int	群组现有成员数。
data.type	String	“group” 群组类型。
data.last_modified	String	最近一次修改的时间戳，单位为毫秒。
data.groupname	String	群组名称。
count	Int	实际获取的群组数量。
cursor	String	查询游标，指定下次查询的起始位置。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#请求示例

第一页

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X GET -H 'Accept: application/json'

-H 'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups?limit=2'

第二页

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X GET -H 'Accept: application/json'

 -H 'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups?limit=2&cursor=ZGNXXXX6Mg'

#响应示例

{ "action": "get", "params": { "limit": ["2"] }, "uri": "https://XXXX/XXXX/XXXX/chatgroups",

"entities": [], "data": [ { "owner": "XXXX#testapp_user1", "groupid": "10XXXX60", "affiliations":

 2, "type": "group", "last_modified": "1441021038124", "groupname": "testgroup1" }, { "owner":

 "XXXX#testapp_user2", "groupid": "10XXXX76", "affiliations": 1, "type": "group", "last_modified":

 "1441074471486", "groupname": "testgroup2" } ], "timestamp": 1441094193812, "duration": 14, "cursor"

: "Y2hhdGdyb3VwczplYXNlbW9iLWRlbW8vY2hhdGRlbW91aV8z", "count": 2 }

#获取单个用户加入的所有群组

根据用户 ID 分页获取指定用户加入的全部群组。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/users/{username}/joined_chatgroups?pagesize={}&pagenum={}

#路径参数

参数及描述详见公共参数。

#查询参数

参数	类型	是否必需	描述
pagesize	String	否	每页获取的群组数量。取值范围为 [1,100]，默认值为 10。
pagenum	String	否	当前页码。默认从第 1 页开始获取。

提示

若请求中均未设置 pagesize 和 pagenum 参数，环信服务器按用户加入群组的时间倒序返回前 500 个群组。

#请求 header

参数	类型	是否必需	描述
Accept	String	是	内容类型。请填 application/json
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.groupid	String	群组 ID。
data.groupname	String	群组名称。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

curl -X GET -H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/

XXXX/users/user1/joined_chatgroups?pagesize=1&pagenum=100'

#响应示例

{ "action": "get", "application": "8bXXXX02", "applicationName": "testapp", "count": 0, "data": [],

"duration": 0, "entities": [], "organization": "XXXX", "params": { "pagesize": ["1"], "pagenum":

["100"] }, "properties": {}, "timestamp": 1645177932072, "uri":

 "https://XXXX/XXXX/XXXX/users/user1/joined_chatgroups" }

#获取群组详情

可以获取一个或多个群组的详情，最多可获取 100 个群组的详情。当获取多个群组的详情时，返回所有存在的群组的详情；对于不存在的群组，返回 “group id doesn’t exist”。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/chatgroups/{group_id}

#路径参数

参数	类型	是否必需	描述
group_id	String	是	要获取详情的群组 ID。最多可传 100 个群组 ID，以逗号分隔。

其他参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.id	String	群组 ID，群组唯一标识符。
data.name	String	群组名称。
data.description	String	群组描述。
data.membersonly	Bool	加入群组是否需要群主或者群管理员审批。 - true：是； - false：否。
data.allowinvites	Bool	是否允许群成员邀请其他用户加入此群。 - true：允许群成员邀请其他用户加入此群； - false：只有群主可以邀请其他用户入群。注：该参数仅对私有群有效，因为公开群不允许群成员邀请其他用户入群。
data.maxusers	Int	群组最大成员数，创建群组的时候设置，可修改。
data.permission	String	群组成员角色： - owner：群主； - member：普通成员。
data.owner	String	群主的用户 ID。例如：{“owner”: “user1”}。
data.created	Long	创建该群组的 Unix 时间戳。
data.affiliations_count	int	群组现有成员总数。
data.disabled	Bool	群组是否为禁用状态： - true：群组被禁用； - false：群组为启用状态。
data.mute	Bool	是否处于全员禁言状态。 - true：是； - （默认）false：否。
data.public	Bool	是否是公开群： - true：公开群； - false：私有群。
data.custom	String	群组扩展信息，例如，可以给群组添加业务相关的标记，不要超过 1,024 字符。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X GET -H 'Accept: application/json' -H

'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups/66XXXX85'

#响应示例

{ "action": "get", "application": "09eXXXX34", "applicationName": "chatdemoui", "count": 1, "data":

[ { "id": "18XXXX3", "name": "XXXX", "description": "test", "membersonly": false, "allowinvites":

 false, "maxusers": 300, "owner": "yifan2", "created": 1656062986845, "custom": "", "mute": false,

 "affiliations_count": 1, "disabled": false, "public": true, "permission": "owner" } ], "duration":

2, "organization": "XXXX", "timestamp": 1656063062633, "uri": "https://XXXX.com/XXXX/chatdemou

i/chatgroups/18XXXX3" }

#删除群组

删除指定的群组。删除群组时会同时删除群组下所有的子区（Thread）。

#HTTP 请求

DELETE https://{host}/{org_name}/{app_name}/chatgroups/{group_id}

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.success	Bool	群组删除结果: - true：删除成功； - false：删除失败。
data.groupid	String	删除的群组的 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X DELETE -H 'Accept: application/json'

 -H 'Authorization: Bearer <YourAppToken>' 'https://a1.Ago ra.com/XXXX/testapp/chatgroups/6XXXX7'

#响应示例

{ "action": "delete", "application": "8bXXXX02", "uri": "https://XXXX/XXXX/XXXX/chatgroups/6XXXX7",

"entities": [], "data": { "success": true, "groupid": "6XXXX7" }, "timestamp": 1542363546590, "duration":

0, "organization": "XXXX", "applicationName": "testapp" }

#管理群组公告和共享文件

#获取群组公告

获取指定群组 ID 的群组公告。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/announcement

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.announcement	String	群公告内容。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X GET -H 'Content-Type: application/json' -

H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/

XXXX/chatgroups/6XXXX7/announcement'

#响应示例

{ "action": "get", "application": "8bXXXX02", "uri": "https://XXXX/XXXX/XXXX/chatgroups/6XXXX7/ann

ouncement", "entities": [], "data": { "announcement": "群组公告..." }, "timestamp": 1542363546590,

"duration": 0, "organization": "XXXX", "applicationName": "testapp" }

#修改群组公告

修改指定群组 ID 的群组公告。群组公告不能超过 512 个字符。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/announcement

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.id	String	群组 ID。
data.result	Bool	修改结果： - true：修改成功； - false：修改失败。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST -H 'Content-Type: application/json

' -H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>' -d '{"announcement" :

 "群组公告…"}' 'https://XXXX/XXXX/XXXX/chatgroups/6XXXX7/announcement'

#响应示例

{ "action": "post", "application": "8bXXXX02", "uri": "https://XXXX/XXXX/XXXX/chatgroups/6XXXX7/

announcement", "entities": [], "data": { "id": "6XXXX7", "result": true }, "timestamp": 15423635465

90, "duration": 0, "organization": "XXXX", "applicationName": "testapp" }

#获取群组共享文件

可以分页获取指定群组 ID 的群组共享文件。获取文件后，你可以根据响应中返回的文件 ID（file_id）调用下载群组共享文件接口下载文件，或调用删除群组共享文件接口删除文件。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/share_files?pagenum={N}&pagesize={N}

#路径参数

参数及描述详见公共参数。

#查询参数

参数	类型	是否必需	描述
pagesize	String	否	每页期望返回的共享文件数。取值范围为 [1,1000]，默认为 1000。
pagenum	Int	否	当前页码。默认从第 1 页开始获取。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.file_id	String	群组共享文件的 ID，若要下载或删除该文件需要使用该参数。
data.file_name	String	群组共享文件名称。
data.file_owner	String	上传群组共享文件的用户 ID。
data.file_size	Long	群组共享文件大小，单位为字节。
data.created	Long	上传群组共享文件的时间。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X GET -H 'Content-Type: application/json'

 -H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chat

groups/6XXXX7/share_files?pagenum=1&pagesize=10'

#响应示例

{ "action": "get", "application": "8bXXXX02", "params": { "pagesize": ["10"], "pagenum": ["1"] }, "uri":

 "https://XXXX/XXXX/XXXX/chatgroups/6XXXX7/share_files", "entities": [], "data": [ { "file_id": "dbd88d2

0-e1d4-11ea-95fc-638fc2d59a8d", "file_name": "159781149272586.jpg", "file_owner": "u1", "file_size": 32612

7, "created": 1597811492594 }, { "file_id": "b30XXXX4f", "file_name": "159781141836993.jpg", "file_owner":

"u1", "file_size": 326127, "created": 1597811424158 } ], "timestamp": 1542363546590, "duration": 0, "organiza

tion": "XXXX", "applicationName": "testapp" }

#上传群组共享文件

上传指定群组 ID 的群组共享文件。注意上传的文件大小不能超过 10 MB。

分页获取指定群组 ID 的群组共享文件，然后可以根据响应中返回的文件 ID（file_id）调用下载群组共享文件接口下载该文件，或调用删除群组共享文件接口删除该文件。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/share_files

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。
Content-Type	String	是	内容类型。请填 multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW。
restrict-access	Bool	否	是否仅群成员可见。 - true：是。 - false：否。
file	String	是	待上传文件的本地路径。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.file_url	String	群组共享文件的 URL，在环信即时通讯 IM 服务器上保存的地址。
data.group_id	String	群组 ID。
data.file_name	String	群组共享文件名称。
data.created	Long	上传群组共享文件的时间。
data.file_id	String	群组共享文件 ID，可以用于下载和删除共享文件。
data.file_size	Long	群组共享文件大小，单位为字节。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST 'https://XXXX/XXXX/XXXX/chatgrou

ps/66021836783617/share_files' -H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>

' -H 'Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' -H 'restrict

-access: true' -F file=@/Users/test/image/IMG_3.JPG

#响应示例

{ "action": "post", "application": "7fXXXXef", "uri": "https://XXXX/XXXX/XXXX/chatgroups/6XXXX7/

share_files", "entities": [], "data": { "file_url": "https://XXXX/XXXX/XXXX/chatgroups/6XXXX7/shar

e_files/c6XXXXc0", "group_id": "6XXXX7", "file_name": "img_3.jpg", "created": 1599050554954, "file_

id": "c6XXXXc0", "file_size": 13512 }, "timestamp": 1599050554978, "duration": 0, "organization":

"XXXX", "applicationName": "testapp" }

#下载群组共享文件

根据指定的群组 ID 与文件 ID（file_id）下载群组共享文件，文件 ID 可从获取群组共享文件接口的响应中获取。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/share_files/{file_id}

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.file_url	String	群组共享文件的 URL，在环信即时通讯 IM 服务器上保存的地址。
data.group_id	String	群组 ID。
data.file_name	String	群组共享文件的名称。
data.created	Long	上传群组共享文件的时间。
data.file_id	String	群组共享文件 ID。该参数在删除共享文件时需要提供。
data.file_size	Long	群组共享文件大小，单位为字节。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X GET -H 'Content-Type: application/json'

-H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>'

'https://XXXX/XXXX/XXXX/chatgroups/6XXXX7/share_files/b30XXXX4f'

#响应示例

{ "action": "post", "application": "7fXXXXef", "uri": "https://XXXX/XXXX/XXXX/chatgroups/6XXXX7

/share_files", "entities": [], "data": { "file_url": "https://XXXX/XXXX/XXXX/chatgroups/6XXXX7/s

hare_files/c6XXXXc0", "group_id": "6XXXX7", "file_name": "img_3.jpg", "created": 1599050554954,

 "file_id": "c6XXXXc0", "file_size": 13512 }, "timestamp": 1599050554978, "duration": 0, "organization"

: "XXXX", "applicationName": "testapp" }

#删除群组共享文件

根据指定的群组 ID 与文件 ID（file_id）删除群组共享文件，文件 ID 可从获取群组共享文件接口的响应中获取。

#HTTP 请求

DELETE https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/share_files/{file_id}

#路径参数

参数	类型	是否必需	描述
file_id	String	是	文件 ID。

其他参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.group_id	String	群组 ID。
data.file_id	String	群组共享文件 ID。在下载共享文件时需提供该参数。
data.result	Bool	删除群组共享文件的结果： - true：删除成功； - false：删除失败。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X DELETE -H 'Content-Type: application/json'

-H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/cha

tgroups/6XXXX7/share_files/b30XXXX4f'

#响应示例

{ "action": "delete", "application": "8bXXXX02", "uri": "https://XXXX/XXXX/XXXX/chatgroups/6XXXX7/share

_files/b30XXXX4f", "entities": [], "data": { "group_id": "6XXXX7", "file_id": "b30XXXX4f", "result": true },

 "timestamp": 1599049350114, "duration": 0, "organization": "XXXX", "applicationName": "testapp" }

#管理群组成员

环信即时通讯 IM 提供多个接口实现对群组成员的管理，包括添加和移除群组成员、转让群组所有权以及群组黑名单、白名单和禁言列表相关操作。

#分页获取群组成员

可以分页获取群组成员列表。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/users?pagenum={N}&pagesize={N}

#路径参数

参数及描述详见公共参数。

#查询参数

参数	类型	是否必需	描述
pagenum	Int	否	当前页码。默认从第 1 页开始获取。
pagesize	Int	否	每页期望返回的群组成员数量。取值范围为 [1,100]。默认为 10。

#请求 header

参数	类型	是否必需	描述
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.owner	String	群主的用户 ID。例如：{“owner”: “user1”}。
data.member	String	群成员的用户 ID。例如：{“member”:“user2”}。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X GET HTTP://XXXX/XXXX/XXXX/chatgroups/10X

XXX85/users?pagenum=2&pagesize=2 -H 'Authorization: Bearer <YourAppToken>'

#响应示例

{ "action": "get", "application": "52XXXXf0", "params": { "pagesize": ["2"], "pagenum": ["2"] }, "uri":

 "https://XXXX/XXXX/XXXX/chatgroups/10XXXX85/users", "entities": [], "data": [ { "member": "user1" },

{ "member": "user2" } ], "timestamp": 1489074511416, "duration": 0, "organization": "XXXX",

 "applicationName": "testapp", "count": 2 }

#添加单个群组成员

每次添加一个群成员。若添加的用户已是群成员，则添加失败，返回错误。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/users/{username}

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.result	Bool	添加结果： - true：成功。 - false：失败。
data.groupid	String	群组 ID。
data.action	String	执行的操作。在该响应中，该字段的值为 add_member，表示添加群组成员。
data.user	String	添加的用户 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST -H 'Content-Type: application/json' -

H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups/66XXXX85/users/user4'

#响应示例

{ "action": "post", "application": "8bXXXX02", "uri": "https://XXXX/XXXX/XXXX/chatgroups/66XXXX85/users/user4",

 "entities": [], "data": { "result": true, "groupid": "66XXXX85", "action": "add_member", "user": "user4" },

 "timestamp": 1542364958405, "duration": 0, "organization": "XXXX", "applicationName": "testapp" }

#批量添加群组成员

一次为群组添加多个成员，每次最多可以添加 60 位成员。如果所有用户均已是群成员，添加失败，返回错误。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/users

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#请求 body

参数	类型	是否必需	描述
usernames	Array	是	要添加为群组成员的用户 ID。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.newmembers	Array	添加的群组成员的用户 ID。
data.groupid	String	群组 ID。
data.action	String	执行的操作。在该响应中，该字段的值为 add_member，表示添加群成员。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST -H 'Content-Type: application/json' -H

'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>' -d '{
   "usernames": [
     "user4","user5"
   ]
 }' 'https://XXXX/XXXX/XXXX/chatgroups/66XXXX85/users'

#响应示例

{ "action": "post", "application": "8bXXXX02", "uri": "https://XXXX/XXXX/XXXX/chatgroups/66XXXX85/users",

"entities": [], "data": { "newmembers": ["user5", "user4"], "groupid": "66XXXX85", "action": "add_member"

 }, "timestamp": 1542365557942, "duration": 0, "organization": "XXXX", "applicationName": "testapp" }

#移除单个群组成员

从群中移除指定成员。如果被移除用户不是群成员，将移除失败，并返回错误。移除后，该成员也会被移除其在该群组中加入的子区。

#HTTP 请求

DELETE https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/users/{username}

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.result	Bool	移除结果： - true：移除成功； - false：移除失败。
data.groupid	String	群组 ID。
data.action	String	执行的操作。在该响应中，该字段的值为 remove_member，表示移除群组成员。
data.user	String	被移除的用户 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X DELETE -H 'Accept: application/json' -H 'Authori

zation: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups/66XXXX85/users/user3'

#响应示例

{ "action": "delete", "application": "8bXXXX02", "uri": "https://XXXX/XXXX/XXXX/chatgroups/66XXXX85

/users/user3", "entities": [], "data": { "result": true, "action": "remove_member", "user": "user3",

"groupid": "66XXXX85" }, "timestamp": 1542365943067, "duration": 0, "organization": "XXXX", "applicationName": "testapp" }

#批量移除群组成员

一次移除多名群成员。如果所有被移除用户均不是群成员，将移除失败，并返回错误。移除后，这些成员也会被移除其在该群组中加入的子区。

#HTTP 请求

DELETE https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/users/{members}

#路径参数

参数	类型	是否必需	描述
members	String	是	要移除的群成员的用户 ID，用户 ID 之间用英文逗号分隔。建议一次最多移除 60 个群成员，并且 URL 的长度不超过 4 KB。

其他参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.result	Bool	操作结果： - true：移除成功； - false：移除失败。
data.action	String	执行的操作。在该响应中，该字段的值为 remove_member，表示移除群组成员。
data.reason	String	操作失败的原因。
data.user	String	被移除成员的用户 ID。
data.groupid	String	操作的群组 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X DELETE -H 'Accept: application/json' -H

'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups/66XXXX85/users/ttXXXX81,user2,user3'

#响应示例

{ "action": "delete", "application": "9bXXXXf7", "uri": "https://XXXX/XXXX/XXXX", "entities": [],

 "data": [ { "result": false, "action": "remove_member", "reason": "user ttXXXX81 doesn't exist.",

"user": "user1", "groupid": "14XXXX79" }, { "result": true, "action": "remove_member", "user": "user2",

 "groupid": "14XXXX79" }, { "result": true, "action": "remove_member", "user": "user3", "groupid":

"14XXXX79" } ], "timestamp": 1433492935318, "duration": 84, "organization": "XXXX", "applicationName": "testapp" }

#设置群成员自定义属性

群成员可设置自定义属性（key-value），例如在群组中的昵称和头像等。

群主可修改所有群成员的自定义属性，其他群成员只能修改自己的自定义属性。

#HTTP 请求

PUT https://{host}/{org_name}/{app_name}/metadata/chatgroup/{group_id}/user/{username}

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#请求 body

参数	类型	是否必需	描述
metaData	JSON	是	要设置的群成员自定义属性，为 key-value 键值对。对于单个键值对： - key 表示属性名称，不能超过 16 字节。 - value 表示属性值，不能超过 512 个字节。若 value 设置为空字符串即删除该自定义属性。注意单个群成员的自定义属性总长度不能超过 4 KB。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data	JSON	设置的群成员自定义属性。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl --location --request PUT 'https://a1-h

sb.easemob.com/easemob-demo/testy/metadata/chatgroup/207059303858177/user/test2' \ -H 'Content-Type

: application/json' \ -H 'Accept: application/json' -H 'Authorization: Bearer YWMtozZwfsFFEe2oQTE6a

ob5eQAAAAAAAAAAAAAAAAAAAAExCXvf5bRGAJBgXNYFJVQ9AQMAAAGG2MUClwBPGgDsI1GYg1QtapTEdGyrm29Eu6L8

qx60lDZ9TJRDOQjEsw' \ --data-raw '{
    "metaData": {
          "key1": "value1"
    }
}'

#响应示例

{ "timestamp": 1678674135533, "data": { "key1": "value1" }, "duration": 53 }

#获取单个群成员的所有自定义属性

获取单个群成员的所有自定义属性。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/metadata/chatgroup/{group_id}/user/{username}

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data	JSON	获取的群成员自定义属性。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl --location --request GET 'https://

a1-hsb.easemob.com/easemob-demo/testy/metadata/chatgroup/207059303858177/user/test2' \ -H 'Co

ntent-Type: application/json' \ -H 'Accept: application/json' -H 'Authorization: Bearer YWMtoz

ZwfsFFEe2oQTE6aob5eQAAAAAAAAAAAAAAAAAAAAExCXvf5bRGAJBgXNYFJVQ9AQMAAAGG2MUClwBPGgDsI1GYg1QtapTEd

Gyrm29Eu6L8qx60lDZ9TJRDOQjEsw' \ --data-raw ''

#响应示例

{ "timestamp": 1678674211840, "data": { "key1": "value1" }, "duration": 6 }

#根据属性 key 获取多个群成员的自定义属性

根据指定的属性 key 获取多个群成员的自定义属性。每次最多可获取 10 个群成员的自定义属性。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/metadata/chatgroup/{group_id}/get

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#请求 body

参数	类型	是否必需	描述
targets	JSON Array	是	要获取自定义属性的群成员的用户 ID。一次最多可传 10 个用户 ID。
properties	JSON Array	是	要获取自定义属性的 key 的数组。若该参数设置为空数组或不传，则获取这些群成员的所有自定义属性。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data	JSON	获取的群成员的自定义属性。如下响应示例中的 test1 和 test2 为自定义属性所属的群成员的用户 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl --location --request POST 'https://

a1-hsb.easemob.com/easemob-demo/testy/metadata/chatgroup/207059303858177/get' \ -H 'Content-Type:

 application/json' \ -H 'Accept: application/json' -H 'Authorization: Bearer YWMtozZwfsFFEe2oQTE6

aob5eQAAAAAAAAAAAAAAAAAAAAExCXvf5bRGAJBgXNYFJVQ9AQMAAAGG2MUClwBPGgDsI1GYg1QtapTEdGyrm29Eu6L8qx60lDZ9TJRDOQjEsw' \ --data-raw '{
    "targets":["test1","test2"],
    "properties":["key1","key2"]
}'

#响应示例

{ "timestamp": 1678674292783, "data": { "test1": { "key1": "value1" }, "test2": { "key1": "value1" } }, "duration": 2 }

#获取群管理员列表

获取群组管理员列表。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/admin

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data	Array	群组管理员的用户 ID 列表。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X GET HTTP://XXXX/XXXX/XXXX/chatgroups/

10XXXX85/admin -H 'Authorization: Bearer <YourAppToken>'

#响应示例

{ "action": "get", "application": "52XXXXf0", "uri": "https://XXXX/XXXX/XXXX/chatgroups/10XXXX

85/admin", "entities": [], "data": ["user1"], "timestamp": 1489073361210, "duration": 0, "organiz

ation": "XXXX", "applicationName": "testapp", "count": 1 }

#添加群管理员

将一个普通群成员设为为群管理员。群管理员有管理黑名单、禁言等权限。最多可以添加 99 个群管理员。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/admin

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#请求 body

参数	类型	是否必需	描述
newadmin	String	是	要添加的新管理员的用户 ID。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data	JSON	群管理员添加结果。
data.result	String	群管理员是否添加成功。
data.newadmin	String	添加的管理员的用户 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST HTTP://XXXX/XXXX/XXXX/c

hatgroups/10XXXX85/admin -d '{"newadmin":"user1"}' -H 'Authorization: Bearer <YourAppToken>'

#响应示例

{ "action": "post", "application": "52XXXXf0", "applicationName": "demo", "data": { "result":

"success", "newadmin": "man" }, "duration": 0, "entities": [], "organization": "XXXX", "properties":

 {}, "timestamp": 1680074570600, "uri": "https://XXXX/XXXX/XXXX/chatgroups/190141728620545/admin" }

#移除群管理员

将用户的角色从群管理员降为群普通成员。

#HTTP 请求

DELETE https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/admin

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.result	Bool	操作结果： - success：表示移除成功; - failure：表示移除失败。
data.oldadmin	String	被移除的管理员用户 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X DELETE HTTP://XXXX/XXXX/XXXX/chatgroups/1

0XXXX85/admin/user1 -H 'Authorization: Bearer <YourAppToken>'

#响应示例

{ "action": "delete", "application": "52XXXXf0", "uri": "https://XXXX/XXXX/XXXX/chatgroups/10XXXX8

5/admin/user1", "entities": [], "data": { "result": "success", "oldadmin": "user1" }, "timestamp":

1489073432732, "duration": 1, "organization": "XXXX", "applicationName": "testapp" }

#转让群组

修改群主为同一群组中的其他成员。

#HTTP 请求

PUT https://{host}/{org_name}/{app_name}/chatgroups/{group_id}

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#请求 body

参数	类型	描述
newowner	String	群组的新管理员的用户 ID。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.newowner	Bool	操作结果： - true：转让成功。 - false：转让失败。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X PUT -H 'Content-Type: application/json'

 -H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>' -d '{     "newowner": "user2"

 }' 'https://XXXX/XXXX/XXXX/chatgroups/66XXXX85'

#响应示例

{ "action": "put", "application": "8bXXXX02", "uri": "https://XXXX/XXXX/XXXX/chatgroups/66XXXX85",

"entities": [], "data": { "newowner": true }, "timestamp": 1542537813420, "duration": 0, "organization":

 "XXXX", "applicationName": "testapp" }

#管理黑名单

环信即时通讯 IM 提供多个接口完成群组黑名单管理，包括查看黑名单中的用户以及将用户加入和移除黑名单等。

#查询群组黑名单

查询一个群组黑名单中的用户列表。黑名单中的用户无法查看该群组的信息，也无法收到该群组的消息。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/blocks/users

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data	Array	群组黑名单上的用户 ID。
count	Int	群组黑名单中的用户数量。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X GET -H 'Accept: application/json' -H '

Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups/66XXXX85/blocks/users'

#响应示例

{ "action": "get", "application": "8bXXXX02", "uri": "https://XXXX/XXXX/XXXX/chatgroups/67178

793598977/blocks/users", "entities": [], "data": ["user2", "user3"], "timestamp": 1543466293681, "

duration": 0, "organization": "XXXX", "applicationName": "testapp", "count": 2 }

#添加单个用户至群组黑名单

将单个用户添加至群组黑名单。群主无法被加入群组的黑名单。

用户进入群组黑名单后会收到加入黑名单的回调。之后，该用户无法查看该群组的信息，也收不到该群组的消息。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/blocks/users/{username}

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.result	Bool	添加结果： - true：添加成功； - false：添加失败。
data.action	String	执行操作。在该响应中，该字段的值为 add_blocks，表示将成员添加至群组黑名单。
data.user	String	添加的用户 ID。
data.groupid	String	群组 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST -H 'Content-Type: application/json'

 -H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX

/chatgroups/66XXXX85/blocks/users/user1'

#响应示例

{ "action": "post", "application": "8bXXXX02", "uri": "https://XXXX/XXXX/XXXX/chatgroups/66XXXX85/bl

ocks/users/user1", "entities": [], "data": { "result": true, "action": "add_blocks", "user": "user1",

"groupid": "66XXXX85" }, "timestamp": 1542539577124, "duration": 27, "organization": "XXXX", "applicationName": "testapp" }

#批量添加用户至群组黑名单

将多个用户添加至群组黑名单，一次最多可以添加 60 个用户。群主无法被加入群组的黑名单。

用户进入群组黑名单后会收到加入黑名单的回调。黑名单上的用户无法查看该群组的信息，也收不到该群组的消息。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/blocks/users

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#请求 body

参数	类型	是否必需	描述
usernames	Array	是	要添加至群组黑名单的用户 ID 数组。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.result	Bool	添加结果： - true：添加成功； - false：添加失败。
data.action	String	执行的操作。在该响应中，该字段的值为 add_blocks，表示将群成员加入群组黑名单。
data.reason	String	添加失败的原因。
data.user	String	添加的用户 ID。
data.groupid	String	群组 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST -H 'Content-Type: application/json'

 -H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>' -d '{
   "usernames": [
     "user3","user4"
   ]
 }' 'https://XXXX/XXXX/XXXX/chatgroups/66XXXX85/blocks/users'

#响应示例

{ "action": "post", "application": "8bXXXX02", "uri": "https://XXXX/XXXX/XXXX/chatgroups/66XXXX85/b

locks/users", "entities": [], "data": [ { "result": false, "action": "add_blocks", "reason": "user:

user3 doesn't exist in group: 66XXXX85", "user": "user3", "groupid": "66XXXX85" }, { "result": true,

"action": "add_blocks", "user": "user4", "groupid": "66XXXX85" } ], "timestamp": 1542540095540, "durat

ion": 16, "organization": "XXXX", "applicationName": "testapp" }

#从群组黑名单移除单个用户

将指定用户移出群组黑名单。对于群组黑名单中的用户，如果需要将其再次加入群组，需要先将其从群组黑名单中移除。

#HTTP 请求

DELETE https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/blocks/users/{username}

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
result	Bool	移除结果： - true：移除成功； - false：移除失败。
action	String	执行的操作。在该响应中，该字段的值为 remove_blocks，表示将群成员移出群组黑名单。
user	String	添加的用户 ID。
groupid	String	群组 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X DELETE -H 'Accept: application/json' -H

'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups/66XXXX85/blocks/users/user1'

#响应示例

{ "action": "delete", "application": "8bXXXX02", "uri": "https://XXXX/XXXX/XXXX/chatgroups/66XXXX85/bl

ocks/users/user1", "entities": [], "data": { "result": true, "action": "remove_blocks", "user": "user1"

 "groupid": "66XXXX85" }, "timestamp": 1542540470679, "duration": 45, "organization": "XXXX", "applicationName": "testapp" }

#从群组黑名单批量移除用户

将多名指定用户从群组黑名单中移除。对于群组黑名单中的用户，如果要将其再次加入群组，需先将其从群组黑名单中移除。

#HTTP 请求

DELETE https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/blocks/users/{usernames}

#路径参数

参数	类型	是否必需	描述
usernames	String	是	要移除群组黑名单的用户 ID。

其他参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.result	Bool	移除结果： - true：移除成功； - false：移除失败。
data.action	String	执行的操作。在该响应中，该字段的值为 remove_blocks，表示将用户从群组黑名单批量移除。
data.user	String	被移除的用户 ID。
data.groupid	String	群组 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X DELETE -H 'Accept: application/json' -

H 'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups/66XXXX85/blocks/users/user1%2Cuser2'

#响应示例

{ "action": "delete", "application": "8bXXXX02", "uri": "https://XXXX/XXXX/XXXX/chatgroups/66XX

XX85/blocks/users/user1%2Cuser2", "entities": [], "data": [ { "result": true, "action": "remove_blo

cks", "user": "user1", "groupid": "66XXXX85" }, { "result": true, "action": "remove_blocks", "user":

 "user2", "groupid": "66XXXX85" } ], "timestamp": 1542541014655, "duration": 29, "organization":

 "XXXX", "applicationName": "testapp" }

#管理白名单

环信即时通讯 IM 提供多个接口实现群组白名单管理，包括查看群组白名单中的用户以及将用户添加至或移除白名单等。

#查询群组白名单

查询群组白名单中的用户列表。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/white/users

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data	Array	群组白名单中的用户 ID 列表。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X GET -H 'Accept: application/json' -H '

Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups/{groupid}/white/users'

#响应示例

{ "action": "get", "application": "XXXX", "uri": "https://XXXX/XXXX/XXXX/chatgroups/12XXXX53/whit

e/users", "entities": [], "data": ["wzy_test", "wzy_vivo", "wzy_huawei", "wzy_xiaomi", "wzXXXXzu"],

"timestamp": 1594724947117, "duration": 3, "organization": "XXXX", "applicationName": "XXXX", "count": 5 }

#添加单个用户至群组白名单

将指定的单个用户添加至群组白名单。用户添加至群组白名单后，当群组全员被禁言时，仍可以在群组中发送消息。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/white/users/{username}

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	描述
data.result	添加结果： - true：添加成功； - false：添加失败。
data.action	执行操作。在该响应中，该字段的值为 add_user_whitelist，表示将成员加入群白名单。
data.user	添加的用户 ID。
data.groupid	群组 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST -H 'Accept: application/json'

-H 'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups/{groupid}/white/users/{username}'

#响应示例

{ "action": "post", "application": "XXXX", "uri": "https://XXXX/XXXX/XXXX/chatgroups/12XXXX53/wh

ite/users/wzy_xiaomi", "entities": [], "data": { "result": true, "action": "add_user_whitelist", "

user": "wzy_xiaomi", "groupid": "12XXXX53" }, "timestamp": 1594724293063, "duration": 4, "organization":

 "XXXX", "applicationName": "XXXX" }

#批量添加用户至群组白名单

添加多个用户至群组白名单。你一次最多可添加 60 个用户。用户添加至白名单后在群组全员禁言时仍可以在群组中发送消息。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/white/users

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#请求 body

参数	类型	描述
usernames	Array	待添加至群组白名单中的用户 ID。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.result	Bool	添加结果： - true：添加成功； - false：添加失败。
data.action	String	执行的操作。在该响应中，该字段的值为 add_user_whitelist，表示将成员加入群白名单。
data.user	String	添加的用户 ID。
data.groupid	String	群组 ID。
data.reason	String	添加失败的原因。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST -H 'Content-Type: application/json'

-H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>' -d '{"usernames" : ["user1"]}'

 'https://XXXX/XXXX/XXXX/chatgroups/{groupid}/white/users'

#响应示例

{ "action": "post", "application": "XXXX", "uri": "https://XXXX/XXXX/XXXX/chatgroups/12XXXX53/white/users",

"entities": [], "data": [ { "result": true, "action": "add_user_whitelist", "user": "wzy_test", "groupid":

"12XXXX53" }, { "result": true, "action": "add_user_whitelist", "user": "wzXXXXzu", "groupid": "12XXXX53" }

], "timestamp": 1594724634191, "duration": 2, "organization": "XXXX", "applicationName": "XXXX" }

#从群组白名单移除用户

将指定用户从群组白名单中移除。你每次最多可移除 60 个用户。

#HTTP 请求

DELETE https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/white/users/{username}

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.result	Bool	移除结果： - true：移除成功； - false：移除失败。
data.action	String	执行的操作。在该响应中，该字段的值为 remove_user_whitelist，表示将成员移出群组白名单。
data.user	String	添加的用户 ID，多个用户 ID 以逗号分隔。
data.groupid	String	群组 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X DELETE -H 'Accept: application/json' -

H 'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups/{groupid}/white/users/{username}'

#响应示例

{ "action": "delete", "application": "XXXX", "uri": "https://XXXX/XXXX/XXXX/chatgroups/12XXXX53/whi

te/users/wzy_huawei,wzXXXXzu", "entities": [], "data": [ { "result": true, "action": "remove_user_wh

itelist", "user": "wzy_huawei", "groupid": "12XXXX53" }, { "result": true, "action": "remove_user_wh

telist", "user": "wzXXXXzu", "groupid": "12XXXX53" } ], "timestamp": 1594725137704, "duration": 1,

"organization": "XXXX", "applicationName": "XXXX" }

#管理禁言

环信即时通讯 IM 提供多个接口进行群组禁言列表管理，包括查看禁言列表以及将用户添加至或移出禁言列表等。

#获取禁言列表

获取当前群组的禁言用户列表。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/mute

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.expire	Long	禁言到期的时间，单位为毫秒。
data.user	String	被禁言用户的 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X GET HTTP://XXXX/XXXX/XXXX/chatgroups/

10XXXX85/mute -H 'Authorization: Bearer <YourAppToken>'

#响应示例

{ "action": "get", "application": "52XXXXf0", "uri": "https://XXXX/XXXX/XXXX/chatgroups/10XXXX85/mute",

"entities": [], "data": [ { "expire": 1489158589481, "user": "user1" } ], "timestamp": 1489072802179,

 "duration": 0, "organization": "XXXX", "applicationName": "testapp" }

#禁言指定群成员

对指定群成员禁言。群成员被禁言后，将无法在群组中发送消息，也无法在该群组下的子区中发送消息。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/mute

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#请求 body

参数	类型	是否必需	描述
mute_duration	Long	是	禁言时长，单位为毫秒。
usernames	Array	是	要添加到禁言列表的用户 ID 列表。每次最多可禁言 10 个成员。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.result	Bool	操作结果： - true：添加成功； - false：添加失败。
data.expire	Long	禁言到期的时间。该时间为 Unix 时间戳，单位为毫秒。
data.user	String	被禁言用户的 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST HTTP://XXXX/XXXX/XXXX

/chatgroups/10XXXX85/mute -d '{"usernames":["user1"], "mute_duration":86400000}' -H 'Authorization: Bearer <YourAppToken>'

#响应示例

{ "action": "post", "application": "52XXXXf0", "uri": "https://XXXX/XXXX/XXXX/chatgroups/10XXXX85/mute",

 "entities": [], "data": [ { "result": true, "expire": 1489158589481, "user": "user1" } ], "timestamp":

1489072189508, "duration": 0, "organization": "XXXX", "applicationName": "testapp" }

#禁言全体群成员

对所有群组成员一键禁言，即将群组的所有成员加入禁言列表。设置群组全员禁言后，仅群组白名单中的用户可在群组以及该群组下的子区内发送消息。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/ban

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.result	Bool	操作结果： - true：禁言成功； - false：禁言失败。
data.expire	Long	禁言到期的时间。该时间为 Unix 时间戳，单位为毫秒。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST -H 'Content-Type: applicat

ion/json' -H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>' 'https:

//XXXX/XXXX/XXXX/chatgroups/{groupid}/ban'

#响应示例

{ "action": "post", "application": "XXXX", "uri": "https://XXXX/XXXX/XXXX/chatgroups/12XXXX53/ban",

 "entities": [], "data": { "mute": true }, "timestamp": 1594628861058, "duration": 1,

 "organization": "XXXX", "applicationName": "XXXX" }

#解除成员禁言

将一个或多个群成员移出禁言列表。移除后，群成员可以在群组中正常发送消息，同时也可以在该群组下的子区中发送消息。

#HTTP 请求

DELETE https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/mute/{member1}(,{member2},…)

#路径参数

参数	类型	是否必需	描述
member	String	是	解除禁言的成员的用户 ID。member1：成员 1 的用户 ID；member2：成员 2 的用户 ID；以此类推。

其他参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.result	Bool	操作结果： - true：解除成功； - false：解除失败。
data.user	Array	被移出禁言列表的用户 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X DELETE -H 'Accept: application/json'

 -H 'Authorization: Bearer <YourAppToken>' 'https://XXXX/XXXX/XXXX/chatgroups/10130212061185/mute/user1'

#响应示例

{ "action": "delete", "application": "52XXXXf0", "uri": "https://XXXX/XXXX/XXXX/chatgroups/10XXXX85/m

ute/user1", "entities": [], "data": [ { "result": true, "user": "user1" } ], "timestamp": 1489072695859,

"duration": 0, "organization": "XXXX", "applicationName": "testapp" }

#解除全员禁言

一键取消对群组全体成员的禁言。解除禁言后，群成员可以在群组和该群组下的子区中正常发送消息。

#HTTP 请求

DELETE https://{host}/{org_name}/{app_name}/chatgroups/{group_id}/ban

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Content-Type	String	是	内容类型。请填 application/json。
Accept	String	是	内容类型。请填 application/json。
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.mute	Bool	是否处于全员禁言状态。 - true：是； - false：否。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X DELETE -H 'Content-Type:

application/json' -H 'Accept: application/json' -H 'Authorization: Bearer <YourAppToken>'

 'https://XXXX/XXXX/XXXX/chatgroups/{groupid}/ban'

#响应示例

{ "action": "delete", "application": "XXXX", "uri": "https://XXXX/XXXX/XXXX/chatgroups/12XXXX53/ban",

"entities": [], "data": { "mute": false }, "timestamp": 1594628899502, "duration": 1

, "organization": "XXXX", "applicationName": "XXXX" }

#管理子区

环信即时通讯 IM 提供多个接口实现子区管理，包括子区的创建、获取、修改和删除等。

单个 app 下的子区总数默认为 10 万，如需调整请联系商务。

#获取 app 中的子区

分页获取应用下的子区列表。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/thread?limit={limit}&cursor={cursor}&sort={sort}

#路径参数

参数及描述详见公共参数。

#查询参数

参数	类型	是否必需	描述
limit	Int	否	每次期望返回的子区数量，取值范围为 [1,50]。
cursor	String	否	数据查询的起始位置。
sort	String	否	获取的子区的排序顺序： - asc：按子区创建时间的正序； - （默认）desc：按子区创建时间的倒序。

#请求 header

参数	类型	是否必需	描述
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
entities.id	String	子区 ID。
properties.cursor	String	查询游标，指定下次查询的起始位置。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X GET https://XXXX/XXXX/XXXX/thre

ad -H 'Authorization: Bearer <YourAppToken>'

#响应示例

{ "action": "get", "applicationName": "testapp", "duration": 7, "entities": [ { "id": "1XXXX8" }

 ], "organization": "XXXX", "properties": { "cursor": "ZGXXXXTE" }, "timestamp": 1650869750247,

 "uri": "https://XXXX/XXXX/XXXX/thread" }

#获取单个用户加入的所有子区（分页获取）

根据用户 ID 获取该用户加入的所有子区。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/threads/user/{username}?limit={limit}&cursor={cursor}&sort={sort}

#路径参数

参数及描述详见公共参数。

#查询参数

参数	类型	是否必需	描述
limit	Int	否	每次期望返回的子区数量，取值范围为 [1,50]。
cursor	String	否	数据查询的起始位置。
sort	String	否	获取的子区的排序顺序： - asc：按用户加入子区的时间的正序； - （默认）desc：按用户加入子区的时间的倒序。

#请求 header

参数	类型	是否必需	描述
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
entities.name	String	子区名称。
entities.owner	String	子区创建者的用户 ID。
entities.id	String	子区 ID。
entities.msgId	String	子区的父消息 ID。
entities.groupId	String	子区所属群组 ID。
entities.created	Long	子区创建时间，Unix 时间戳。
properties.cursor	String	查询游标，指定服务器下次查询的起始位置。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X GET https://XXXX/XXXX/XXXX/t

hreads/user/test4 -H 'Authorization: Bearer <YourAppToken>'

#响应示例

{ "action": "get", "applicationName": "testapp", "duration": 4, "entities": [ { "name": "1",

 "owner": "test4", "id": "17XXXX69", "msgId": "1920", "groupId": "17XXXX61", "created": 165

0856033420 } ], "organization": "XXXX", "properties": { "cursor": "ZGXXXXzg" }, "timestamp":

 1650869972109, "uri": "https://XXXX/XXXX/XXXX/threads/user/test4" }

#获取单个用户在指定群组中加入的所有子区 (分页获取)

根据用户 ID 获取该用户在指定群组中加入的所有子区。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/threads/chatgroups/{group_id}/user/{username}?limit={limit}&cursor={cursor}&sort={sort}

#路径参数

参数及描述详见公共参数。

#查询参数

参数	类型	是否必需	描述
limit	Int	否	每次期望返回的子区数量，取值范围为 [1,50]。该参数仅在分页获取时为必需。
cursor	String	否	数据查询的起始位置。该参数仅在分页获取时为必需。
sort	String	否	获取的子区的排序顺序： - asc：按用户加入子区的时间的正序； - （默认）desc：按用户加入子区的时间的倒序。

#请求 header

参数	类型	是否必需	描述
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	描述	描述
entities.name	String	子区名称。
entities.owner	String	子区的创建者。
entities.id	String	子区 ID。
entities.msgId	String	子区的父消息 ID。
entities.groupId	String	子区所属群组 ID。
entities.created	Long	子区创建时间，Unix 时间戳，单位为毫秒。
properties.cursor	String	查询游标，指定下次查询的起始位置。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X GET https://XXXX/XXXX/XXXX/threads

/chatgroups/XXXX/user/XXXX -H 'Authorization: Bearer <YourAppToken>'

#响应示例

{ "action": "get", "applicationName": "testapp", "duration": 4, "entities": [ { "name": "1",

"owner": "test4", "id": "17XXXX69", "msgId": "1920", "groupId": "17XXXX61", "created": 1650856

033420 } ], "organization": "XXXX", "properties": { "cursor": "ZGXXXXNzg" }, "timestamp": 1650

869972109, "uri": "https://XXXX/XXXX/XXXX/threads/user/test4" }

#创建子区

创建子区。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/thread

#路径参数

参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#请求 body

参数	类型	是否必需	描述
group_id	String	是	子区所在的群组 ID。
name	String	是	子区名称，不能超过 64 个字符。
msg_id	String	是	子区的父消息 ID。
owner	String	是	子区的所有者，即创建子区的群成员。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.thread_id	String	创建的子区 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST https://XXXX/XXXX/XXXX/thread

-H 'Authorization: Bearer <YourAppToken>' -d '{
    "group_id": 179800091197441,
    "name": "1",
    "owner": "test4",
    "msg_id": 1234
}'

#响应示例

{ "action": "post", "applicationName": "testapp", "duration": 4, "data": { "thread_id": "1XXXX7" }

 "organization": "XXXX", "timestamp": 1650869972109, "uri": "https://XXXX/XXXX/XXXX/thread" }

#修改子区

修改指定子区。

#HTTP 请求

PUT https://{host}/{org_name}/{app_name}/thread/{thread_id}

#路径参数

参数	类型	是否必需	描述
thread_id	String	是	子区 ID。

其他参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#请求 body

参数	类型	是否必需	描述
name	String	是	要修改的子区的名称。修改后的子区名称不能超过 64 个字符。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中包含以下字段：

字段	类型	描述
data.name	String	修改后的名称。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X PUT https://XXXX/XXXX/XXXX/thread

/1XXXX7 -H 'Authorization: Bearer <YourAppToken>' -d '{"name": "test4"}'

#响应示例

{ "action": "put", "applicationName": "testapp", "duration": 4, "data": { "name": "test4" } "

organization": "XXXX", "timestamp": 1650869972109, "uri": "https://XXXX/XXXX/XXXX/thread" }

#删除子区

删除指定子区。

#HTTP 请求

DELETE https://{host}/{org_name}/{app_name}/thread/{thread_id}

#路径参数

参数	类型	是否必需	描述
thread_id	String	是	子区 ID。

其他参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功。响应包体中包含以下字段：

字段	类型	描述
data.status	String	删除结果，ok 表示成功删除。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X DELETE https://XXXX/XXXX/XXXX/threa

d/1XXXX7 -H 'Authorization: Bearer <YourAppToken>'

#响应示例

{ "action": "delete", "applicationName": "testapp", "duration": 4, "data": { "status": "ok" }, "

organization": "XXXX", "timestamp": 1650869972109, "uri": "https://XXXX/XXXX/XXXX/thread" }

#管理子区成员

环信即时通讯 IM 提供多个接口实现子区成员管理，包括对加入和踢出子区等管理功能。

#获取子区成员列表(分页)

获取指定子区的成员列表。

#HTTP 请求

GET https://{host}/{org_name}/{app_name}/thread/{thread_id}/users?limit={N}&cursor={cursor}

#路径参数

参数及描述详见公共参数。

#查询参数

参数	类型	是否必需	描述
limit	Int	否	每次期望返回的子区成员数量，取值范围为 [1,50]。该参数仅在分页获取时为必需。
cursor	String	否	数据查询的起始位置。该参数仅在分页获取时为必需。

#请求 header

参数	类型	是否必需	描述
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功。响应包体中包含以下字段：

字段	类型	描述
affiliations	Array	子区成员的用户 ID 列表。
properties.cursor	String	查询游标，指定下次查询的起始位置。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X GET https://XXXX/XXXX/XXXX/thread/1

XXXX7/users -H 'Authorization: Bearer <YourAppToken>'

#响应示例

{ "action": "get", "data": { "affiliations": ["test4"] }, "duration": 4, "properties": { "cursor":

 "ZGNXXXXyMA" }, "timestamp": 1650872048366, "uri": "https://XXXX/XXXX/XXXX/thread/1XXXX8/users" }

#用户批量加入子区

用户批量加入指定的子区。

#HTTP 请求

POST https://{host}/{org_name}/{app_name}/thread/{thread_id}/users

#路径参数

参数	类型	是否必需	描述
thread_id	String	是	子区 ID。

其他参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#请求 body

参数	类型	是否必需	备注
usernames	List	是	批量加入子区的用户 ID 列表。每次最多支持 10 个用户加入子区。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功。响应包体中包含以下字段：

字段	类型	描述
data.status	String	添加结果，ok 表示成功添加。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X POST https://XXXX/XXXX/XXXX/thread/1XXXX7/users -d '{
"usernames": [
"test2",
"test3"
]
}' -H 'Authorization: Bearer <YourAppToken>'

#响应示例

{ "action": "post", "applicationName": "testapp", "data": { "status": "ok" }, "duration": 1069, "

organization": "XXXX", "timestamp": 1650872649160, "uri": "https://XXXX/XXXX/XXXX/thread/1XXXX8/joined_thread" }

#批量踢出子区成员

批量踢出子区成员。

#HTTP 请求

DELETE https://{host}/{org_name}/{app_name}/threads/{thread_id}/users

#路径参数

参数	类型	是否必需	描述
thread_id	String	是	子区 ID。

其他参数及描述详见公共参数。

#请求 header

参数	类型	是否必需	描述
Authorization	String	是	App 管理员的鉴权 token，格式为 Bearer YourAppToken，其中 Bearer 为固定字符，后面为英文空格和获取到的 app token。

#请求 body

参数	类型	是否必需	备注
usernames	List	是	批量踢出子区的用户 ID 列表。每次最多可踢出 10 个子区成员。

#HTTP 响应

#响应 body

如果返回的 HTTP 状态码为 200，表示请求成功。响应包体中包含以下字段：

字段	类型	描述
result	Bool	操作结果。 - true：成功； - false：失败。
user	String	被踢出子区的用户 ID。

其他字段及描述详见公共参数。

如果返回的 HTTP 状态码非 200，表示请求失败。你可以参考响应状态码了解可能的原因。

#示例

#请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token curl -X DELETE https://XXXX/XXXX/XXXX/th

read/1XXXX7/users -H 'Authorization: Bearer <YourAppToken>'

#响应示例

{ "action": "delete", "applicationName": "testy", "duration": 12412, "entities": [ { "res

ult": false, "user": "test2" }, { "result": false, "user": "test6" } ], "organization": "XXXX",

 "timestamp": 1650874050419, "uri": "https://XXXX/XXXX/XXXX/thread/1XXXX8/users" }

相似文档

环信IM即时通讯（服务端） - 聊天室管理
环信即时通讯 IM 提供了 RESTful API 管理 App 中的群组。单个 App 创建群组数量有限制，而且单个用户可加入群组的数量视版本而定，详见使用限制。前提条件：要调用环信即时通讯 RESTful API，请确保满足以下要求：已在环信即时通讯 IM 管理后台开通配置环信即时通讯 IM 服务。了解环信 IM RESTful API 的调用频率限制，详见接口频率限制。
环信IM即时通讯（服务端） - 在线状态（Presence）订阅
在线状态（Presence）表示用户的当前状态信息。除了环信 IM 内置的在线和离线状态，你还可以添加自定义在线状态，例如忙碌、马上回来、离开、接听电话、外出就餐等。本文展示如何调用环信即时通讯 RESTful API 实现用户在线状态（Presence）订阅，包括设置用户在线状态信息、批量订阅和获取在线状态、取消订阅以及查询订阅列表。
环信IM即时通讯（服务端） - 消息表情回复 Reaction REST API
消息表情回复（“Reaction”）指用户在单聊和群聊场景中对单条消息回复表情，可丰富用户聊天时的互动方式。本页介绍如何使用即时通讯 IM RESTful API 实现 Reaction 功能。前提条件：要调用环信即时通讯 RESTful API，请确保满足以下要求：已在环信即时通讯云控制台开通配置环信即时通讯 IM 服务。已从服务端获取 app token，详见使用 App Token 鉴权。了解环信 IM RESTful API 的调用频率限制，详见接口频率限制。
环信IM即时通讯（服务端） - Java Server SDK
功能概述： Server SDK 是对环信 IM REST API 的封装，这样做是为了节省服务器端开发者对接环信 API 的时间，只需要配置自己的 App Key 相关信息即可使用。 Server SDK 提供了用户、消息、群组、聊天室等资源的操作管理能力。
环信IM即时通讯（服务端） - PHP Server SDK
介绍： PHP SDK 是对环信 IM REST API 的封装，旨在节省服务器端开发者对接环信 API 的时间，只需要配置自己的 App Key 相关信息即可使用。功能： PHP SDK 提供了用户、消息、群组、聊天室等资源的操作管理能力。依赖： PHP 5.3+

文档中心

全民上云·上云补贴申领

免费试用（限企业）

#前提条件

#公共参数

#请求参数

#响应参数

#群组角色

#认证方式

#创建和管理群组

#创建群组

#HTTP 请求

#路径参数

#请求 header

#请求 body

#HTTP 响应

#响应 body

#示例

#请求示例

#响应示例

#封禁群组

#HTTP 请求

#路径参数

#请求 header

#HTTP 响应

#响应 body

#示例

#请求示例

#响应示例

#解禁群组

#HTTP 请求

#路径参数

#请求 header

#HTTP 响应

#响应 body

#示例

#请求示例

#响应示例

#修改群组信息

#HTTP 请求

#路径参数

#请求 header

#请求 body

#HTTP 响应

#响应 body

#示例

#请求示例

#响应示例

#获取 App 中的群组

#HTTP 请求

#路径参数

#查询参数

#请求 header

#HTTP 响应

#响应 body

#请求示例

#响应示例

#获取单个用户加入的所有群组

#HTTP 请求

#路径参数

#查询参数

#请求 header

#HTTP 响应

#响应 body

#示例

#请求示例

#响应示例

#获取群组详情

#HTTP 请求

#路径参数

#请求 header

#HTTP 响应

#响应 body

#示例

#请求示例

#响应示例

#删除群组

#HTTP 请求

#路径参数

#请求 header