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

全员推送

POST

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

全员推送,是指向所有在线用户(包括消息发送用户自己)、离线用户发送特定内容的消息,如文本、图片等。本功能适用于全员活动公告、送礼跨房间飘屏等场景。

  • 在线用户:登录 ZIM 并且心跳未超时的用户。
  • 离线用户:登录 ZIM 并上报 ZPNsPushId 之后,心跳超时的用户。
说明
  • 如需使用本功能,请开通 ZIM 专业版或旗舰版服务。
  • 通过本接口发送的消息不会导致会话产生,也不会被保存。

消息接收用户仅通过以下 ZIM SDK 的回调接口,接收全员推送的消息,得知消息由哪位用户发出。

iOSAndroidmacOSWindows
broadcastMessageReceivedonBroadcastMessageReceivedbroadcastMessageReceivedonBroadcastMessageReceived
Web小程序FlutterReact Native
broadcastMessageReceivedbroadcastMessageReceivedonBroadcastMessageReceivedbroadcastMessageReceived
uni-app | uni-app xHarmonyOS
broadcastMessageReceivedbroadcastMessageReceived
说明

参数 FromUserId 仅支持数字,英文字符和 '!','#','$','%','&','(',')','+','-',':',';','<','=','.','>','?','@','[',']','^','_',' ','{','}','|','~'

如果发送方使用的 SDK 版本(版本说明请参考 发布日志)低于 2.0.0,ZIM 服务端对应的仅支持 MessageType2 的 Command 类型消息,不支持其他类型。
为了给开发者带来更好的体验,ZEGO 推荐开发者使用最新版本的 SDK。

消息接收方的 SDK 版本必须为 2.10.0 或以上,才能接受全员推送消息。

说明
调用频率限制:1 次/秒,每 24 小时内仅限 100 次,如需调整,请联系 ZEGO 技术支持。

Request

Query Parameters

    Action string必填

    可选值: [SendMessageToAllUsers]

    接口原型参数

    https://zim-api.zego.im/?Action=SendMessageToAllUsers

    AppId uint32必填

    💡公共参数。应用 Id,由 ZEGO 分配的用户唯一凭证。可从 ZEGO 控制台 获取。

    SignatureNonce string必填

    💡公共参数。16 位 16 进制随机字符串(8 字节随机数的 hex 编码)。生成算法可参考 签名示例

    Timestamp int64必填

    💡公共参数。当前 Unix 时间戳,单位为秒。生成算法可参考 签名示例,最多允许 10 分钟的误差。

    SignatureVersion string必填

    可选值: [2.0]

    默认值: 2.0

    💡公共参数。签名版本号。

    Signature string必填

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

Body

required
    FromUserId string必填

    可选值: <= 32 characters

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

    MessageType number必填

    消息类型,全员推送的适用类型请参考 MessageBody 说明

    MessageBody object必填

    消息内容,具体参数格式请参考 MessageBody 说明

    SubMsgType number

    具体的自定义类型。值由开发者定义,取值范围为 [0,200]。当 MessageType 为自定义消息时,才需赋值此参数。

    PushType number

    推送类别:

    • 0:对在线用户进行在线推送。
    • 1:对在线用户进行在线推送,对离线用户进行离线推送。
    • 2:对所有上报了 ZPNsPushId 的用户进行离线推送。

Responses

OK
Schema
    Code number

    返回码。

    说明

    当您发起请求同时向多个用户发送消息时:

    • 如果只需成功向 1 个或以上的用户发送消息,Code 都会返回 0,表示成功。此时请参考 ErrorList 中的具体信息,确认操作结果,了解是否向部分用户发送消息失败。
    • 如果向所有用户发送消息都失败,Code 会返回相关返回码,具体请参考 全局返回码

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

    返回码说明处理建议
    660000002输入参数错误。请检查输入的参数。
    660400001输入的消息大小超出限制。请检查输入的消息大小。
    660500002消息发送者未登录 SDK。请登录 ZIM SDK 后再发送消息。
    660500003调用 SendMessageToAllUsers 接口的频率超出限制。请稍后再试。
    Message string

    请求结果的说明信息。

    RequestId string

    请求 ID。

上一篇

发送房间消息

下一篇

编辑消息

当前页

返回到顶部