跳到主要内容

功能说明​

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

请求说明​

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

请求类型:POST

请求限频:100次/秒

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

Content-Type:application/json

请求参数​

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

请求示例​

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"
}