集成与自动化

接入方式

Bridge 固定监听本机。除健康检查外，外部脚本必须在启动应用前配置 HBUT_BRIDGE_TOKEN，并发送同值 Bearer Token。

请求示例

GET  http://127.0.0.1:4399/health
POST http://127.0.0.1:4399/login        Authorization: Bearer $HBUT_BRIDGE_TOKEN
POST http://127.0.0.1:4399/sync_grades  Authorization: Bearer $HBUT_BRIDGE_TOKEN

完整接口清单请参考「Tauri API 手册」。

NoneBot 调用示例

import os
import httpx
from nonebot import on_command

cmd = on_command("成绩")
token = os.environ["HBUT_BRIDGE_TOKEN"]

@cmd.handle()
async def handle():
    headers = {"Authorization": f"Bearer {token}"}
    async with httpx.AsyncClient() as client:
        resp = await client.post(
            "http://127.0.0.1:4399/sync_grades",
            headers=headers,
        )
        resp.raise_for_status()
        data = resp.json()
        await cmd.finish(f"课程数: {len(data.get('data', {}).get('grades', []))}")

安全与限频

• Bridge 固定监听 127.0.0.1，不接受局域网或公网绑定。
• 除 /health 和只读嵌入资源外，脚本请求必须携带 HBUT_BRIDGE_TOKEN。
• 缓存 API 还会按接口要求校验 JWT scope。
• 高频任务建议加本地缓存，避免触发登录频率限制。