直达内容

消息回执

POST /acknowledgements

接收消息需要先与 Mixin Server 建立 WebSocket 连接。收到消息后需要通知服务器消息已投递或已读,否则服务器会持续推送。

该接口用于批量上报消息状态。

API 端点 URL

 https://api.mixin.one/acknowledgements

授权和其他选项

授权
Authorized
限制No limitation

请求体

[
{ "message_id": "消息 UUID", "status": "READ" },
{ "message_id": "消息 UUID", "status": "READ" },
...
]

请求示例

curl -i -X POST -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" https://api.mixin.one/acknowledgements --data '[{"message_id":"928c5c40-769c-3e97-8387-fb1ae0645311", "status":"READ"}]'
Response
[
// 每次最多 100 条
{ "message_id": "UUID", "status": "READ" },
...
]