Skip to main content

功能说明

服务端消息撤回功能无撤回时间限制,开发者服务端可通过此接口在任意时间以任意人的身份撤回消息,撤回操作的指令自动同步至各端,同时支持在撤回指令中增加扩展信息。

请求说明

请求鉴权:接口需要增加验证 Header,请查看 鉴权说明

请求类型POST

请求限频100次/秒

请求地址:https://请求域名/apigateway/hismsgs/recall

Content-Typeapplication/json

请求参数

参数数据类型是否必填参数说明
from_idstring单聊会话时,会话一方用户的id
target_idstring单聊会话时,会话另一方用户的id;群聊会话时,群id
channel_typeint会话类型,1:单聊;2:群聊
msg_idstring要撤回消息的id
msg_timeint要撤回消息的时间戳
extsmap可携带扩展数据,用于端上定制化展示

请求示例

POST /apigateway/hismsgs/recall HTTP/1.1
appkey: appkey
signature: 2e639ae3600a4sdff61fb88b76f485b
nonce: nonce
timestamp: 1672568121910
Content-Type: application/json

{
"from_id":"xxx",
"target_id":"xxx",
"channel_type":1,
"msg_id":"xxxx",
"msg_time":1569345643212,
"exts":{
"k1":"v1"
}
}

响应示例

{
"code":0,
"msg":"sucess"
}