logo
即时通讯
机器人
ZIM Audio
当前页

转让群主

GET

https://zim-api.zego.im/

通过该接口可以将群主身份转移给群内其他成员。

转让成功后,群内成员通过以下 ZIM SDK 的回调接口,收到相关通知:

iOSAndroidmacOSWindows
groupMemberInfoUpdatedonGroupMemberInfoUpdatedgroupMemberInfoUpdatedonGroupMemberInfoUpdated
Web小程序FlutterReact Native
groupMemberInfoUpdatedgroupMemberInfoUpdatedonGroupMemberInfoUpdatedgroupMemberInfoUpdated
Unity3Duni-app | uni-app xHarmonyOS
OnGroupMemberInfoUpdatedgroupMemberInfoUpdatedgroupMemberInfoUpdated
说明

参数 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必填

    💡公共参数。签名,用于验证请求的合法性。请参考签名机制生成。

    FromUserId string必填

    可选值: <= 32 characters

    操作者用户 ID(已在客户端调用 login 方法登录 ZIM 服务,或已调用 服务端 API 完成注册)。

    GroupId string必填

    可选值: <= 32 characters

    群 ID。

    NewOwner string必填

    可选值: <= 32 characters

    新群主(接收转让的用户) ID,需为群内用户。

Responses

OK
Schema
    Code number

    返回码。

    以下仅列出了接口业务逻辑相关的返回码,完整返回码请参考 全局返回码

    返回码说明处理建议
    660000002参数错误。请检查请求参数。
    660300006超出调用频率限制。请稍后再试。
    660500002操作者用户未注册。请先注册该用户。
    660600001群不存在。请检查 GroupID 是否正确。
    660600024接受转让的用户不在群内。请将该用户拉进群内。
    Message string

    操作结果描述。

    RequestId string

    请求 ID。


ZEGO 签名生成器
Request
折叠所有
Base URL
https://zim-api.zego.im
统一接入地址(不区分区域)
Parameters
query必填
query必填
query必填
query必填
query必填
query必填
query必填
query必填
query必填
RESPONSE清除

点击上方 “发送” 按钮,在此处查看响应。

Previous

移除群成员

Next

添加群成员

当前页

返回到顶部