转让群主
描述
通过该接口可以将群主身份转移给群内其他成员。
转让成功后，群内成员通过以下 ZIM SDK 的回调接口，收到相关通知：
| iOS | Android | macOS | Windows | Web |
|---|---|---|---|---|
| groupMemberInfoUpdated | onGroupMemberInfoUpdated | groupMemberInfoUpdated | onGroupMemberInfoUpdated | groupMemberInfoUpdated |
| 小程序 | Flutter | Unity3D | uni-app | React Native |
| groupMemberInfoUpdated | onGroupMemberInfoUpdated | OnGroupMemberInfoUpdated | groupMemberInfoUpdated | groupMemberInfoUpdated |
接口原型
- 请求方法：GET
- 请求地址：
https://zim-api.zego.im/?Action=TransferGroupOwner - 传输协议：HTTPS
- 调用频率限制：1 次/秒，群级别限制。如需调整，请联系 ZEGO 技术支持。
请求参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表请参考 调用方式 - 公共请求参数。
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| FromUserId | String | 是 | 操作者用户 ID。 |
| GroupId | String | 是 | 群 ID。 |
| NewOwner | String | 是 | 新群主（接收转让的用户） ID，需为群内用户。 |
说明
FromUserId、GroupId、NewOwner 仅支持数字，英文字符和 '!'，'#'，'$'，'%'，'&'，'('，')'，'+'，''，':'，';'，'<'，'='，'.'，'>'，'?'，'@'，'['，']'，'^'，'_'，'{'，'}'，'|'，'~'。
请求示例
Untitled
https://zim-api.zego.im/?Action=TransferGroupOwner
&FromUserId=zego_user&GroupId=groupid&NewOwner=newowner
&<公共请求参数>
1
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| Code | Number | 返回码。 |
| Message | String | 操作结果描述。 |
| RequestId | String | 请求 ID。 |
响应示例
Untitled
{
"Code": 0,
"Message": "success",
"RequestId": "343649807833778782"
}
1
返回码
以下仅列出了接口业务逻辑相关的返回码，完整返回码请参考 全局返回码。
| 返回码 | 说明 | 处理建议 |
|---|---|---|
| 660000002 | 参数错误。 | 请检查请求参数。 |
| 660300006 | 超出调用频率限制。 | 请稍后再试。 |
| 660500002 | 操作者用户未注册。 | 请先注册该用户。 |
| 660600001 | 群不存在。 | 请检查 GroupID 是否正确。 |
| 660600024 | 接受转让的用户不在群内。 | 请参考 添加群成员 将该用户拉进群内。 |