群组托管导入
该接口用于将信息托管未开启下创建的群组导入为托管的群组,导入需要设置群主和群权限。操作后,群组支持使用群组托管功能接口(包括 SDK 侧的群组功能接口)。
提示
导入后不会触发任何回调。
开通服务
调用此接口前,您须在控制台开通信息托管服务。详情请参阅开启用户信息托管。
请求方法
POST: https://数据中心域名/entrust/group/import.json
频率限制: 每秒钟限 100 次
签名规则: 所有服务端 API 请求均需要进行规则校验,详见 API 请求签名。
正文参数
HTTP 请求正文数据格式为 application/x-www-form-urlencoded
,支持以下 HTTP 表单参数:
参数 | 类型 | 必传 | 说明 |
---|---|---|---|
groupId | String | 是 | 群组ID,最大长度 64 个字符。支持大小写英文字母与数字的组合。 |
name | String | 是 | 群名称,最长不超过 64 个字符,群名称可以重复创建。 |
owner | String | 是 | 群主ID |
groupProfile | String | 否 | 群组基本信息, 为 JSON 数据,具体的key参考下方详情。 |
permissions | String | 否 | 群组权 限信息, 为 JSON 数据,具体的key参考下方详情。 |
groupExtProfile | String | 否 | 群组扩展信息,为 JSON 格式。键(key)的前缀必须加 ext_ ,其长度不超过 32 个字符;值(value)的长度不超过 256 个字符; 键值对(KV)默认可设置 10个。 |
groupProfile
中的 key 如下:
key 值 | 类型 | 长度/取值范围 | 描述 |
---|---|---|---|
introduction | String | 长度不超过 512 个字符 | 群简介 |
announcement | String | 长度不超过 1024 个字符 | 群公告 |
portraitUrl | String | 长度不超过 128 个字符 | 群头像地址 |
permissions
中的 key 如下:
key 值 | 类型 | 长度/取值范围 | 描述 |
---|---|---|---|
joinPerm | Number | 取值范围:
| 加入群权限 |
removePerm | Number | 取值范围:
| 将群成员移出群组权限 |
memInvitePerm | Number | 取值范围:
| 邀请他人入群权限 |
invitePerm | Number | 取值范围:
| 邀请加入群组处理方式 |
profilePerm | Number | 取值范围:
| 修改群资料及权限 |
memProfilePerm | Number | 取值范围:
| 设置群成员资料权限 |
请求示例
POST /entrust/group/import.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=2222334444&name=testGName&owner=newOwner