API 文档

GET 健康检查 公开

{
  "status": "ok",
  "service": "智慧校园物联网API",
  "version": "2.0",
  "time": "2026-07-28 12:00:00"
}

GET 仪表盘 公开

返回统计、最近告警、用户摘要、系统状态等。

GET 统计 公开

GET 告警列表 公开

• level：级别过滤（如 high / warning / info）
• processed / status：处理状态
• location：地点
• severity：可选

GET 设备列表 公开

GET 人员 / 用户 公开

返回 users 表摘要字段（id、username、nickname、联系方式、角色等）。

POST 上报告警 公开

JSON Body 示例：

{
  "event_type": "parking_access",
  "location": "地下停车场入口",
  "message": "检测到异常通行",
  "details": "可选详情",
  "alert_level": "high",
  "person_type": "student"
}

成功时返回 success / id / alert_id。

JS 客户端也可使用：

smartCampus.sendAlert({
  event_type: "parking_access",
  location: "地下停车场入口",
  person_type: "student"
});

POST 标记已处理 公开

{ "id": 123, "user": "admin" }

批量：action=alert_process_until，同样 POST { id, user }。

POST / DELETE 清空已处理历史 公开

POST 兼容设备入口 公开

旧设备端可用 JSON 或表单字段：

• event_type / alert_type
• location
• details / message
• alert_level（critical 会映射为 high）

管理后台 API 需登录

需先访问 /admin/login.html 登录（Session / Remember Cookie）。

• dashboard / stats / alerts（支持 level、processed、limit、offset 等）
• alert：单条查询 / 处理（GET、PUT/POST、DELETE）
• staff：人员 CRUD（GET/POST/PUT/DELETE）
• alerts_clear：DELETE 清空