TransferGroupOwner
2026-07-08
GET
https://zim-api.zego.im/
通过该接口可以将群主身份转移给群内其他成员。
转让成功后，群内成员通过以下 ZIM SDK 的回调接口，收到相关通知：
| iOS | Android | macOS | Windows |
|---|---|---|---|
| groupMemberInfoUpdated | onGroupMemberInfoUpdated | groupMemberInfoUpdated | onGroupMemberInfoUpdated |
| Web | 小程序 | Flutter | React Native |
|---|---|---|---|
| onGroupMemberInfoUpdated | onGroupMemberInfoUpdated | onGroupMemberInfoUpdated | onGroupMemberInfoUpdated |
| Unity3D | uni-app | uni-app x | HarmonyOS |
|---|---|---|
| OnGroupMemberInfoUpdated | groupMemberInfoUpdated | groupMemberInfoUpdated |
说明
参数 FromUserId、GroupId、NewOwner 仅支持数字，英文字符和 '!'，'#'，'$'，'%'，'&'，'('，')'，'+'，''，':'，';'，'<'，'='，'.'，'>'，'?' ，'@'，'['，']'，'^'，'_'，'{'，'}'，'|'，'~'。
说明
调用频率限制：1 次/秒，群级别限制。如需调整，请联系 ZEGO 技术支持。
Request
Query Parameters
Action string必填
可选值: [TransferGroupOwner]
接口原型参数
https://zim-api.zego.im/?Action=TransferGroupOwner
AppId uint32必填
💡公共参数。应用 Id，由 ZEGO 分配的用户唯一凭证。可从 ZEGO 控制台 获取。
SignatureNonce string必填
💡公共参数。16 位 16 进制随机字符串（8 字节随机数的 hex 编码）。生成算法可参考 签名示例。
Timestamp int64必填
💡公共参数。当前 Unix 时间戳，单位为秒。生成算法可参考 签名示例，最多允许 10 分钟的误差。
SignatureVersion string必填
可选值: [2.0]
默认值: 2.0
💡公共参数。签名版本号。
Signature string必填
💡公共参数。签名，用于验证请求的合法性。请参考签名机制生成。
GroupId string必填
可选值: <= 32 characters
群 ID。
NewOwner string必填
可选值: <= 32 characters
新群主（接收转让的用户） ID，需为群内用户。
Responses
- 200
OK
- application/json