标记消息已读

POST

/index.php

用于标记消息已读。

认证要求以参数说明为准；未标记认证的接口仍可能受到访问频率和安全策略限制。

请求可使用 JSON（Content-Type: application/json）或表单编码；字段含义、必填性和示例以本接口定义为准。

可能的失败结果

HTTP 状态	errno	英文错误信息	中文释义
400	`400001`	A required parameter is missing.	缺少必填参数。
401	`401002`	The API key is invalid.	API Key 无效。

所有响应均包含 request_id，排查问题时请一并提供该值。

请求参数

Query 参数

Body 参数application/json必填

示例

{
    "api_key": "",
    "message_id": ""
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://qiuxian.net.cn//index.php?route=api%2Fnotifications%2Fmark_message_read' \
--header 'Content-Type: application/json' \
--data '{
    "api_key": "",
    "message_id": ""
}'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
    "errno": 0,
    "data": {
        "message": "已标记为已读"
    }
}

🟠400

🟠401

修改于 2026-10-20 12:34:11

获取站内信列表

标记单条消息已读

标记消息已读

可能的失败结果#

请求参数

请求示例代码

返回响应

可能的失败结果