跳到主要内容

加入群组

该接口用于加入已存在的群组。

开通服务​

信息托管服务已默认开通，您可以直接调用此接口。详情请参阅信息托管服务。

请求方法​

POST：https://数据中心域名/entrust/group/join.json

频率限制：每秒 100 次。该接口支持调整频率（可调频），可在控制台 > IM 服务 > 服务购买 > 调频服务中调整。

签名规则：所有服务端 API 请求均需要进行规则校验，详见 API 请求签名。

正文参数​

HTTP 请求正文数据格式为 application/x-www-form-urlencoded，支持以下 HTTP 表单参数：

参数类型必传说明
groupIdString是群组 ID
userIdsArray是加入群的用户 ID：一次最多可以添加 100 个用户

请求示例​

HTTP
POST /entrust/group/join.json HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/x-www-form-urlencoded

groupId=groupId1&userIds=userId

返回结果​

HTTP 响应正文包含具有以下结构的 JSON 对象：

返回值返回类型说明
codeNumber业务状态码。200 表示操作成功。
groupIdString群 ID
nameString群名称
groupProfileString群组基本信息，为 JSON 数据
groupExtProfileString群扩展信息，为 JSON 格式
permissionsString群权限信息，为 JSON 格式
ownerString群主
createTimeLong群创建时间
memberCountNumber群成员数量

groupProfile 中的 key 如下：

key 值类型描述
introductionString群简介，长度不超过 512 个字符
announcementString群公告，长度不超过 1024 个字符
portraitUrlString群头像地址，长度不超过 128 个字符

permissions 中的 key 如下：

key 值类型长度/取值范围描述
joinPermNumber取值范围：
  • 0：需要群主验证（默认）
  • 1：不用验证
  • 2：群管理员或群主验证
  • 3：不允许任何人加入
加入群权限
removePermNumber取值范围：
  • 0：群主（默认）
  • 1：群主+群管理员
  • 2：所有人
将群成员移出群组权限
memInvitePermNumber取值范围：
  • 0：群主（默认）
  • 1：群主+群管理员
  • 2：所有人
邀请他人入群权限
invitePermNumber取值范围：
  • 0：不需要被邀请人同意（默认）
  • 1：需要被邀请人同意
邀请加入群组处理方式
profilePermNumber取值范围：
  • 0：群主（默认）
  • 1：群主+群管理员
  • 2：所有人
修改群资料及权限
memProfilePermNumber取值范围：
  • 0：群主+群管理员+自己（默认）
  • 1：群主+自己
  • 2：仅自己
设置群成员资料权限

返回结果示例​

HTTP
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "code": 200,
    "groupId":"gorupId1",
    "createTime":1717717737377,
    "owner":"userId1",
    "name":"gName1",
    "groupExtProfile":"{\"ext_key1\":\"value1\",\"ext_key2\":\"value2\"}",
    "memberCount":10
}