API 调试工具

可用 API 接口 ▶

系统接口

• GET /api/health 健康检查，返回服务状态及普通/散称商品条数
• GET /api/version 获取版本号及各文件哈希

鉴权接口

• 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/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/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/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/snapshots 快照列表（需鉴权）
• POST /api/products-s/snapshots/:file/restore 恢复快照（需鉴权）
• GET /api/products-s/snapshots/:file/diff 快照对比（需鉴权）