代金券系统

API文档与使用指南

系统概述

这是一个代金券管理系统的后端API服务,提供了客户端和管理端两种角色的API接口。系统已成功启动并连接到数据库。

注意:系统运行在 http://localhost:3000,所有API请求都需要以 /api/ 开头。

管理端API

管理端API用于系统管理员进行用户管理、代金券管理、统计分析等操作。

管理员认证

  • POST /api/admin/login
    管理员登录,获取JWT令牌

用户管理

  • GET /api/admin/users
    获取所有用户列表
  • GET /api/admin/user/:id
    获取单个用户详情

代金券管理

  • GET /api/admin/voucher
    获取所有代金券列表
  • POST /api/admin/voucher
    创建新的代金券
  • PUT /api/admin/voucher/:id
    更新代金券信息
  • DELETE /api/admin/voucher/:id
    删除代金券

统计与记录

  • GET /api/admin/statistics
    获取系统统计数据
  • GET /api/admin/record
    获取消费记录

客户端API

客户端API用于普通用户进行登录、查看和使用代金券等操作。

用户认证

  • POST /api/client/user/login
    用户登录

代金券相关

  • GET /api/client/voucher/list
    获取可用代金券列表
  • POST /api/client/voucher/receive
    领取代金券
  • GET /api/client/voucher/my
    获取我的代金券

消费相关

  • POST /api/client/consumption/create
    创建消费记录
  • GET /api/client/consumption/list
    获取消费历史

使用示例

管理员登录

POST /api/admin/login
Content-Type: application/json

{
  "username": "admin",
  "password": "123456"
}

查看可用代金券

GET /api/client/voucher/list
Authorization: Bearer YOUR_JWT_TOKEN

系统状态

✅ 服务器已成功启动并运行在端口 3000

✅ 数据库连接成功(MySQL 9.4.0-commercial)

✅ 所有表结构已创建完成

✅ 初始数据已导入成功

提示:使用Postman或其他API测试工具可以更方便地测试这些API接口。