即时通讯
  • iOS
  • Android : Java
  • macOS
  • Windows
  • Web
  • 小程序
  • Flutter
  • Unity3D
  • uni-app
  • React Native
  • 产品简介
  • 下载
  • 快速开始
    • 跑通示例源码
    • 实现基本消息收发
  • 用户相关
  • 房间相关
  • 群组相关
  • 消息相关
  • 呼叫邀请
  • 会话管理
  • 缓存管理
  • 离线推送
  • 语音组件
  • 客户端 API
  • 服务端 API
  • 迁移方案
  • SDK 错误码
  • 常见问题
  • 文档中心
  • 即时通讯
  • 服务端 API
  • 消息相关
  • 撤回单聊消息

撤回单聊消息

更新时间:2024-02-27 17:53

描述

调用此接口,您可以撤回 2 分钟内的单聊会话消息。如需撤回更早之前的消息,请联系 ZEGO 技术支持,最多可撤回 24 小时内发出的消息。

消息撤回后,消息接收用户将通过以下 ZIM SDK 的回调接口,接收消息已被撤回的通知。

接口原型

  • 请求方法:POST
  • 请求地址: https://zim-api.zego.im/?Action=RevokePeerMessage
  • 传输协议:HTTPS
  • 调用频率限制:20 次/秒。

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表请参考 调用方式 - 公共请求参数

参数 类型 是否必选 描述
FromUserId
String
消息发送者用户 ID。
ToUserId
String
消息接收方的用户 ID。
MsgSeq
Number
消息 seq。获取方式:

  • 若需要撤回由客户端发出的单聊消息,通过 消息发送后回调 获取 MsgSeq。
  • 若需要撤回由 服务端 API SendPeerMessage 发出的单聊消息,通过接口响应数据获取 MsgSeq。
Payload
String
撤回操作附加的信息,最大 200 字节。
OfflinePush
Object
离线推送配置,详情请参考 OfflinePush 说明

请求示例

  • 请求地址 URL:

    https://zim-api.zego.im/?Action=RevokePeerMessage
    &<公共请求参数>
  • 请求消息体:

    {
        "FromUserId": "u1",
        "ToUserId": "u2",
        "MsgSeq": 10,
        "Payload": "payload",
        "OfflinePush" :{
            "Enable":1,
            "Title":"title",
            "Content":"content",
            "Payload":"payload"
        }
    }

响应参数

参数 类型 描述
Code
Number
返回码。
Message
String
请求结果的说明信息。
RequestId
String
请求 ID。

响应示例

{
    "Code": 0,
    "Message": "success",
    "RequestId": "343649807833778782"
}

返回码

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

返回码 说明 处理建议
660000002
参数错误。
请参考 请求参数 输入正确参数。
660000022
未找到消息,可能是消息已经被删除或者消息不存在。
请检查消息是否被删除,以及 MsgSeq 是否正确。
660000023
消息已被撤回。
请确认消息是否已被撤回。
  • 如经确认,消息已被撤回,则无需处理。
  • 如经确认,消息未被撤回,请联系 ZEGO 技术支持排查问题。
660000024
已超过撤回时间。
如需撤回更长时间内的消息,请联系 ZEGO 技术支持进行配置。
660000026
待撤回消息与 FromUserId 不匹配。
请检查 FromUserId 字段是否正确。
660300005
调用接口的频率超出了 AppID 级别限制。
请稍后再试,或参考相关文档了解调用频率。
本篇目录