API 调试工具

可用 API 接口 ▶

系统接口

• GET /api/health 健康检查，返回服务状态及普通/散称商品条数
• GET /api/version 获取版本号及各文件哈希
• GET /api/announcement 获取启用的公告列表（公开），返回 {announcements:[...], announcement:首条兼容}，无公告返回空数组/null
• GET /api/announcements 获取全部公告列表（含禁用，需 X-Admin-Token 头）
• POST /api/announcements 新建公告 {title,content,mode:'modal'|'banner',enabled,images:[],order}（需 X-Admin-Token 头）
• PUT /api/announcements/:id 更新指定公告（需 X-Admin-Token 头）
• DELETE /api/announcements/:id 删除指定公告（需 X-Admin-Token 头）
• POST /api/announcements/reorder 批量更新排序 {orders:{id:orderValue}}（需 X-Admin-Token 头）
• POST /api/announcement 【兼容旧版】发布/更新/关闭单条公告（操作最新一条），需 X-Admin-Token 头
• POST /api/announcement/upload 公告图片上传 {image:'data:image/png;base64,...'}，返回 {url}（需 X-Admin-Token 头，≤5MB，png/jpg/gif/webp）

鉴权接口

• POST /api/auth/login 登录，获取会话 token
• POST /api/auth/logout 登出，销毁当前会话（需 X-Admin-Token 头）
• GET /api/auth/session 查询当前会话状态（需 X-Admin-Token 头）
• POST /api/auth/verify 口令校验（需 X-Admin-Password 头）

功能开关 / 本机授权

• GET /api/features 功能开关状态 {stockQuery, replenishQuery, moveQuery, flowQuery, labourQuery}（公开，默认全开）
• PUT /api/features 保存功能开关（需 X-Admin-Token 头），关闭后对应接口返回 403
• POST /api/device-auth/claim 申请/获取本机四位识别码 {deviceId}（公开，重复调用返回同一个码）
• GET /api/device-auth/status?deviceId= 查询本机授权状态（公开，首页每 3 秒轮询）
• GET /api/device-auth/list 授权列表（需 X-Admin-Token 头，含识别码 / 状态 / 备注 / 申请时间 / IP）
• POST /api/device-auth/authorize 授权 / 取消授权 / 保存备注 {code, remark, authorized}（需 X-Admin-Token 头）

统计接口

• GET /api/stats 获取运行统计数据
• POST /api/stats/barcode 条码生成上报
• POST /api/stats/pageview 页面访问上报
• POST /api/stats/visitor 访客上报
• GET /api/stats/barcode-records 条码生成记录（需鉴权）
• POST /api/stats/reset 重置统计数据（需鉴权）

日志接口（需鉴权）

• GET /api/logs/dates?type=access 获取可用日志日期列表（type: access/action/error）
• GET /api/logs?type=&date=&page=&pageSize=&keyword= 查询日志（支持分页、关键词筛选）

劳动能力 (/api/labour，需本机授权)

• GET /api/labour/query?name=&pageNo=&pageSize= 按姓名查询人员及能力（已授权设备用 X-Device-Id，管理员用 X-Admin-Token；IP 限流 1 次/5 秒）
• POST /api/labour/group-query 姓名组批量查询 {names:[...]}，最多 30 人，串行 + 姓名缓存 3 分钟
• GET /api/labour/configs 一级能力配置（缓存 10 分钟，?refresh=1 强制刷新）
• POST /api/labour/sub-capacities 批量查询子能力 {codes:[...]}
• POST /api/labour/capacity/:laborId 保存某人能力 {capacities:[...]}（保存前写 labour_logs 修改记录）
• POST /api/labour/capacity-batch 批量保存能力 {items:[{laborId,capacities}]}，最多 30 人/次，姓名组快速切换使用
• GET /api/labour/level-configs 等级能力配置（如「边拣边播组包上限」+ 可选值；缓存 10 分钟，?refresh=1 强制刷新）
• POST /api/labour/level-capacity/:laborId 保存等级能力 {levelCapacities:[{code,value:{name,value}}]}，服务端按配置补齐 name
• GET /api/labour/groups 分组列表（姓名组 / 能力组 / 快速切换规则，data 含 subs / onSubs / offSubs / levels）
• POST /api/labour/groups 新增分组 {type:'name'|'cap'|'switch', name, data}
• PUT /api/labour/groups/:id 修改分组 {name, data}（类型不可改）
• POST /api/labour/groups/reorder 分组排序 {type:'switch', ids:[...]}，按数组顺序重写 sort（快速切换选项上移/下移）
• DELETE /api/labour/groups/:id 删除分组
• GET /api/labour/logs?page=&pageSize=&keyword=&laborId= 劳动能力修改记录（需 X-Admin-Token 头，含能力/子能力/等级能力变更明细）

普通商品 (/api/products)

• GET /api/products 获取所有商品数据
• GET /api/products/count 获取商品数量
• GET /api/products/barcode/:barcode 按条码查询商品
• GET /api/products/code/:code 按编码查询商品
• GET /api/products/search?keyword=xxx 按商品名称搜索
• GET /api/products/search-barcode?keyword=xxx 按条码或编码搜索
• GET /api/products/query?input=xxx 综合查询（条码或编码）
• GET /api/products/list?page=&pageSize=&keyword=&sort= 分页搜索列表
• GET /api/products/export 导出 JSON
• POST /api/products/reload 重新加载 products.json 文件
• POST /api/products 新增单条商品（需鉴权）
• PUT /api/products/:barcode 更新商品（需鉴权）
• DELETE /api/products/:barcode 删除商品（需鉴权）
• POST /api/products/import 导入 {data,mode}（需鉴权）
• GET /api/products/blacklist 导入黑名单列表（需鉴权）
• POST /api/products/blacklist 加入黑名单 {keys,note}，keys 支持条码/编码（精确）/名称（模糊）（需鉴权）
• DELETE /api/products/blacklist/:key 移出黑名单（需鉴权）
• GET /api/products/snapshots 快照列表（需鉴权）
• POST /api/products/snapshots/:file/restore 恢复快照（需鉴权）
• GET /api/products/snapshots/:file/diff 快照对比（需鉴权）

散称商品 (/api/products-s)

• GET /api/products-s 获取所有商品数据
• GET /api/products-s/count 获取商品数量
• GET /api/products-s/barcode/:barcode 按条码查询商品
• GET /api/products-s/code/:code 按编码查询商品
• GET /api/products-s/search?keyword=xxx 按商品名称搜索
• GET /api/products-s/search-barcode?keyword=xxx 按条码或编码搜索
• GET /api/products-s/query?input=xxx 综合查询（条码或编码）
• GET /api/products-s/list?page=&pageSize=&keyword=&sort= 分页搜索列表
• GET /api/products-s/export 导出 JSON
• POST /api/products-s/reload 重新加载 products_s.json 文件
• POST /api/products-s 新增单条商品（需鉴权）
• PUT /api/products-s/:barcode 更新商品（需鉴权）
• DELETE /api/products-s/:barcode 删除商品（需鉴权）
• POST /api/products-s/import 导入 {data,mode}（需鉴权）
• GET /api/products-s/blacklist 导入黑名单列表（需鉴权）
• POST /api/products-s/blacklist 加入黑名单 {keys,note}，keys 支持条码/编码（精确）/名称（模糊）（需鉴权）
• DELETE /api/products-s/blacklist/:key 移出黑名单（需鉴权）
• GET /api/products-s/snapshots 快照列表（需鉴权）
• POST /api/products-s/snapshots/:file/restore 恢复快照（需鉴权）
• GET /api/products-s/snapshots/:file/diff 快照对比（需鉴权）