GetBulletin 获取公告
程序信息类查询入口：返回该程序后台配置的公告标题与正文。客户端可在启动时弹出公告，用于维护通知、停服预告等。
| 项目 | 值 |
|---|---|
| action | GetBulletin |
| 入口 | Handle POST https://www.a7p.cn/api/verify/{ApiPassword} |
| 是否计入验证统计 | 否 |
调用步骤
- 完成 Init 握手，拿到
ApiPassword。 - 拼接明文：
action=GetBulletin（无需任何业务参数）。 - RC4 加密 + MD5 签名，POST 到 Handle 接口。
code == 200→ 读取data.title与data.content。
请求参数
本接口不需要业务参数，明文只需 action：
text
action=GetBulletin业务规则
- 公告内容来自后台「程序公告」配置，未填写时
content为空字符串。 title默认格式为「<程序名> 公告」。
请求示例
python
# 复用 /api/handle 页面中的 handle() 与 rc4() 函数
API_PW = "A1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6"
result = handle(API_PW, "action=GetBulletin")
if result["code"] == 200:
d = result["data"]
if d.get("content"):
print(f"【{d['title']}】\n{d['content']}")
else:
print("当前无公告")
else:
print(f"查询失败 {result['code']}: {result['message']}")text
.版本 2
.子程序 A7_获取公告, 逻辑型
.参数 ApiPassword, 文本型
.局部变量 TimeStamp, 文本型
.局部变量 加密参数, 文本型
.局部变量 Sign, 文本型
.局部变量 返回文本, 文本型
.局部变量 状态码, 文本型
TimeStamp ＝ 到文本 (时间_取现行时间戳 ())
加密参数 ＝ RC4加密 (ApiPassword, "action=GetBulletin")
Sign ＝ 取数据摘要 (到字节集 (ApiPassword ＋ TimeStamp ＋ 加密参数))
返回文本 ＝ 到文本 (网页_访问 ("https://www.a7p.cn/api/verify/" ＋ ApiPassword, 1, "TimeStamp=" ＋ TimeStamp ＋ "&Sign=" ＋ Sign ＋ "&Data=" ＋ 加密参数))
状态码 ＝ JSON_解析 (返回文本, "code")
.判断开始 (状态码 ＝ "200")
.如果 (JSON_解析 (返回文本, "data.content") ≠ "")
信息框 (JSON_解析 (返回文本, "data.content"), 0, JSON_解析 (返回文本, "data.title"))
.如果结束
.默认
信息框 ("查询失败：" ＋ JSON_解析 (返回文本, "message"), 0, )
.判断结束
返回 (假)成功响应
json
{
"code": 200,
"message": "success",
"data": {
"title": "示例程序 公告",
"content": "系统将于本周日 02:00-04:00 进行维护升级，期间验证服务暂不可用。"
}
}| 字段 | 类型 | 说明 |
|---|---|---|
title | string | 公告标题，默认 <程序名> 公告 |
content | string | 公告正文，未配置时为空字符串 |
错误码
该接口本身不校验业务参数，失败通常由握手层错误引起（如 1001 程序不存在、1010 签名错误、1012 程序未审核通过）。完整列表见错误码对照表。