大家好，我是南月。

by我自己只是为了说明这个是“非官方”的邀请。

最近在考虑做私信的功能，所以用灵犀搓了个后台服务用于中转消息，不过这样也仅限于使用了我开发的扩展的用户才能使用。

现在社区扩展使用量本就不高，扩展也分散，所以我感觉私信功能开放一个API，大家都接入，相互也能发，这样才能最大化的体现私信的作用。

以下为接口信息：

前置说明

• 执行顺序：

1. 发送消息，调用message_send接口；

2. 获取消息，调用message_receive接口；

3. 扩展获取消息并处理完成后，调用message_receive_confirm接口标记已读，否则下次还会重复获取这些消息。

• 需要登记客户端名和一段验证用的密钥，32位字母和数字，相符服务端才进行相应处理（不建议公布出来，防止接口被恶意调用）。

• 消息内容建议限制9999个字符（实际长度65535字节），仅支持纯文本。

• 服务器带宽有限，消息内容太多可能上传下载的时间会长。

• 发送POST请求，Params无内容，所有请求都在Body中，使用json格式。

• 不要在聊天中透漏自己的隐私信息。

通用约定

接口地址：https://wpsbbsplus.sthmoon.com/api/

2.1 鉴权

除鉴权失败外，每个请求必须携带以下两个字段：

服务端在进入任何业务逻辑前先校验客户端名与密钥，不匹配直接返回：

{ "server_time": "2026-09-04 12:00:00", "result": "01", "message": "密钥验证不通过" }

缺少任一字段返回 "message": "缺少客户端名或密钥"。

2.2 统一响应结构

消息、活动查询接口在统一结构上额外附带业务字段（见各接口说明）。

2.3 通用校验规则

3.私信聊天

3.1 message_send — 私信发送

服务端接收并保存私信，内容为纯文本，明文入库，已接收 置 0。

请求

请求示例

{
  "client_name": "wpsbbs-extension",
  "secret_key": "0123456789abcdef0123456789abcdef",
  "sender_uid": "10001",
  "receiver_uid": "10002",
  "message_time": "2026-09-04 12:00:00",
  "content": "你好，这是一条测试消息"
}

响应：统一结构。成功示例：

{ "server_time": "2026-09-04 12:00:01", "result": "00", "message": "" }

错误分支

3.2 message_receive — 私信接收

查询指定接收者的未接收消息（已接收=0），此操作只读，不改变消息状态。

请求

响应：统一结构 + messages 数组。

响应示例

{
  "server_time": "2026-09-04 12:00:02",
  "result": "00",
  "message": "",
  "messages": [
    { "message_id": 1, "sender_uid": "10001", "message_time": "2026-09-04 12:00:00", "content": "你好" }
  ]
}

3.3 message_receive_confirm — 已读确认

将消息标记为已接收。服务端先对整批消息做全量校验，任何一条不匹配则整批拒绝、一条都不标记；全部通过后在单个事务中标记。

请求

请求示例

{
  "client_name": "wpsbbs-extension",
  "secret_key": "0123456789abcdef0123456789abcdef",
  "messages": [
    { "message_id": 1, "receiver_uid": "10002" },
    { "message_id": 2, "receiver_uid": "10002" }
  ]
}

响应：统一结构。

错误分支