返回菜单

API 文档与日志

开发者 API 接口 (v1)
GET/api/v1/menu
获取最新菜单数据。后端会自动计算北京时间，并返回 today_month 和 today_day 供前端实现高亮。
POST/api/v1/menu
更新菜单。支持智能合并：未传的字段保留旧值。若菜单正文变化，旧正文会自动归档到历史表。
{"password": "***", "text": "新菜单", "version": "第十周"}
DELETE/api/v1/menu/text
只清空菜单正文，替换为等待占位符，保留供餐时间和版本号。
{"password": "***"}
DELETE/api/v1/menu
彻底重置系统所有数据。
{"password": "***"}
GET/api/v1/history
获取最近 5 次更新的历史菜单备份。
GET/api/v1/system/health
系统健康检查，返回 Worker 运行状态、D1 数据库连接状态及当前北京时间。
GET/api/v1/system/stats
获取系统数据统计（当前记录数、历史记录数、最后更新时间）。
更新日志 (Changelog)
2026-11-04
v1.3.3 当前版本
  • 全新子页面：上线 API 文档与更新日志页面，提升系统专业度。
  • 顶栏大重构：将原主卡片中的标题、版本号、更新时间合并至顶部悬浮栏。
  • 精准定位优化：点击顶栏校区按钮，现在会直接平滑滚动至该校区“今日高亮”区域，而非单纯的校区顶部。
  • 样式极限瘦身：大幅缩减所有嵌套容器的内边距（Padding），解决手机端文字因空间挤压导致的一字一行问题。
2026-11-03
v1.2.5
  • API 规范化改造：后端接口全面升级为 RESTful v1 标准（如 GET /api/v1/menu）。
  • 统一响应格式：所有接口固定返回 {success, message, data} JSON 结构，加入标准 HTTP 状态码。
  • 请求体解析兼容：新增统一解析器 parseBody，完美兼容表单提交和 JSON 接口请求。
  • 新增历史归档：创建 menu_history 数据表，每次更新自动备份旧菜单。
  • 新增系统监控：加入健康检查 /health 和统计接口 /stats。
2026-10-25
v1.1.0
  • 前后端分离架构：前端展示页迁移至 Cloudflare Pages，Worker 仅负责 API 与后台管理。
  • 性能大幅提升：借助 Pages 的全球 CDN，首屏静态加载速度极快，彻底摆脱 Worker 拼装长字符串。
  • 多校区视图隔离：前端实现按“校区”自动分区，并为每个校区生成独立的卡片容器。
  • 防丢机制：后端实现“智能合并”，只改版本号或供餐时间时，不会覆盖现有菜单正文。
2026-10-18
v1.0.0
  • 系统首发上线：基于 Cloudflare Workers + D1 数据库搭建纯 Serverless 架构。
  • 精准时区处理：强制使用北京时间（UTC+8）进行日期判断，实现今日菜单的高亮外框。
  • 白嫖安全证书：解决免费域名 SSL 签发问题，开启强制 HTTPS，防止运营商劫持。
  • 接入第三方统计：对接 51.la 并在管理页实现数据看板展示。