跳到主要内容

功能说明​

标记消息的已读状态。

请求说明​

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

请求类型:POST

请求限频:100次/秒

请求地址:https://请求域名/apigateway/messages/markread

Content-Type:application/json

请求参数​

参数数据类型是否必填参数说明
user_idstring是消息的已读用户id;最多 32 个字符
target_idstring是该消息的会话id,单聊时为消息发送者id,群聊时为群id;最多 32 个字符
channel_typeint是会话类型:1:单聊;2:群聊
msg_idsarray是要标记已读的消息id列表;数组元素(消息 ID)最多 20 个字符

请求示例​

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

{
"user_id":"userid1",
"target_id":"userid2",
"channel_type":1,
"msg_ids":["xxxxxxx","yyyyyyy"]
}

响应示例​

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