加入群组

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

开通服务

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

请求方法

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

频率限制：每秒 100 次

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

正文参数

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

参数	类型	必传	说明
groupId	String	是	群组 ID
userIds	Array	是	加入群的用户 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 对象：

返回值	返回类型	说明
code	Number	业务状态码。200 表示操作成功。
groupId	String	群 ID
name	String	群名称
groupProfile	String	群组基本信息，为 JSON 数据
groupExtProfile	String	群扩展信息，为 JSON 格式
permissions	String	群权限信息，为 JSON 格式
owner	String	群主
createTime	Long	群创建时间
memberCount	Number	群成员数量

groupProfile 中的 key 如下：

key 值	类型	描述
introduction	String	群简介，长度不超过 512 个字符
announcement	String	群公告，长度不超过 1024 个字符
portraitUrl	String	群头像地址，长度不超过 128 个字符

permissions 中的 key 如下：

key 值	类型	长度/取值范围	描述
joinPerm	Number	取值范围： 0：需要群主验证（默认） 1：不用验证 2：群管理员或群主验证 3：不允许任何人加入	加入群权限
removePerm	Number	取值范围： 0：群主（默认） 1：群主+群管理员 2：所有人	将群成员移出群组权限
memInvitePerm	Number	取值范围： 0：群主（默认） 1：群主+群管理员 2：所有人	邀请他人入群权限
invitePerm	Number	取值范围： 0：不需要被邀请人同意（默认） 1：需要被邀请人同意	邀请加入群组处理方式
profilePerm	Number	取值范围： 0：群主（默认） 1：群主+群管理员 2：所有人	修改群资料及权限
memProfilePerm	Number	取值范围： 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
}