1
auth-api/
2
├── index.html              # 前端登录/注册页面
3
├── admin.html              # 管理员后台（需登录）
4
├── API-DOCS.md             # 外部站点接入文档
5
├── API-FLOW.md             # API 完整流程文档（架构/数据流/认证机制）
6
├── README.md               # 本文件
7
├── example-client.php      # 外部站点集成示例
8
├── api/
9
│   ├── config.php          # 配置文件（支持 settings.json 覆盖）
10
│   ├── auth.php            # 前端页面 API（注册/登录/修改密码/验证）
11
│   ├── external.php        # 外部站点 API（需 API Key）
12
│   ├── room.php            # 房间管理 API（创建/加入/踢人/消息）
13
│   ├── admin.php           # 管理员后台 API
14
│   ├── db.php              # JSON 数据层（文件锁 + 自动存储 username）
15
│   ├── middleware.php       # 中间件（CORS、动态 API Key 验证、限流）
16
│   └── token.php           # Token 生成与验证
17
├── assets/
18
│   └── favicon.svg         # 网站图标
19
└── data/
20
    ├── .htaccess           # 禁止 Web 直接访问 JSON
21
    ├── users.json          # 用户数据（自动创建）
22
    ├── admin.json          # 管理员密码（自动创建）
23
    ├── settings.json       # 系统设置（后台修改后自动创建）
24
    ├── api_keys.json       # API Key 列表（后台生成后自动创建）
25
    ├── rate_limit.json     # 速率限制记录（自动创建）
26
    └── admin.log           # 管理员操作日志（自动创建）

1
require_once 'example-client.php';
2

3
$result = registerUser('username', 'password');  // 注册
4
$result = loginUser('username', 'password');      // 登录
5
$result = verifyToken($token);                    // 验证 Token
6
$result = checkUsername('newuser');                // 检查用户名