# apirhs **Repository Path**: mksrc/apirhs ## Basic Information - **Project Name**: apirhs - **Description**: API 计费管理系统 - 创客API计费系统，支持API调用计费、用户管理、支付集成等功能 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 2 - **Forks**: 0 - **Created**: 2026-02-18 - **Last Updated**: 2026-02-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 创客 API 计费系统 一个功能完整的 API 计费管理系统，支持 API 调用计费、用户管理、支付集成等功能。 ## 项目简介 创客 API 计费系统是一个基于 PHP + MySQL 开发的 API 计费管理平台，为企业和个人提供 API 服务调用计费、用户管理、支付集成等一站式解决方案。系统支持多种支付方式，提供完善的统计分析功能，帮助您轻松管理 API 服务。 ## 核心功能 ### 用户管理 - 用户注册与登录 - 用户信息管理 - 密码重置功能 - 用户权限管理 ### API 密钥管理 - API 密钥生成与管理 - 密钥权限配置 - 密钥使用统计 - 密钥有效期管理 ### TOKEN 计费系统 - TOKEN 充值功能 - TOKEN 消费统计 - 支持小数计费（精确到小数点后4位） - TOKEN 余额查询 - 消费记录查询 ### 支付集成 - 支持翼支付/BestPay 支付网关 - 支持多种支付方式（支付宝、微信支付） - 支付回调处理 - 支付订单管理 - 充值卡功能 ### 统计分析 - API 调用统计 - 用户消费统计 - 收入统计 - 数据可视化展示 ### 后台管理 - 系统配置管理 - 用户管理 - API 服务管理 - 支付设置 - 订单管理 - 数据备份 ## 技术栈 ### 后端技术 - **PHP 7.4+** - 核心开发语言 - **MySQL 5.7+** - 数据库 - **PDO** - 数据库操作 - **原生 PHP** - 无框架依赖 ### 前端技术 - **HTML5** - 页面结构 - **CSS3** - 样式设计 - **JavaScript** - 交互逻辑 - **原生 JavaScript** - 无框架依赖 ### 服务器要求 - **Apache** 或 **Nginx** - Web 服务器 - **PHP 7.4 或更高版本** - **MySQL 5.7 或更高版本** - **mod_rewrite** 或 URL 重写支持 ### 支付网关 - **翼支付/BestPay** - 主要支付网关 - 支持支付宝、微信支付等多种支付方式 ## 系统架构 ``` apirhs/ ├── admin/ # 后台管理系统 │ ├── index.php # 后台首页 │ ├── login.php # 后台登录 │ ├── logout.php # 后台登出 │ └── pages/ # 后台页面 │ ├── dashboard.php # 仪表板 │ ├── users.php # 用户管理 │ ├── api-keys.php # API密钥管理 │ ├── api-services.php # API服务管理 │ ├── payment-settings.php # 支付设置 │ ├── token-orders.php # TOKEN订单管理 │ ├── token-packages.php # TOKEN套餐管理 │ ├── subscriptions.php # 订阅管理 │ ├── recharge-cards.php # 充值卡管理 │ └── settings.php # 系统设置 │ ├── api/ # API 接口 │ ├── index.php # API 入口 │ ├── payment.php # 支付回调处理 │ ├── debug.php # 调试接口 │ └── .htaccess # URL 重写规则 │ ├── includes/ # 核心功能模块 │ ├── db.php # 数据库连接 │ ├── auth.php # 认证功能 │ ├── functions.php # 公共函数 │ ├── payment.php # 支付功能 │ ├── bestpay.php # 翼支付集成 │ ├── logger.php # 日志功能 │ ├── backup.php # 备份功能 │ ├── installer.php # 安装程序 │ └── upgrade.php # 升级程序 │ ├── public/ # 前台页面 │ ├── index.php # 首页 │ ├── login.php # 登录页 │ ├── register.php # 注册页 │ ├── dashboard.php # 用户中心 │ ├── profile.php # 个人资料 │ ├── api-keys.php # API密钥管理 │ ├── api-services.php # API服务列表 │ ├── api-test.php # API测试 │ ├── billing.php # 账单管理 │ ├── token-purchase.php # TOKEN购买 │ ├── subscription.php # 订阅管理 │ ├── payment-settings.php # 支付设置 │ ├── analytics.php # 数据分析 │ ├── install.php # 安装向导 │ ├── system-check.php # 系统检查 │ ├── epay-submit.php # 支付提交 │ ├── favicon.svg # 网站图标 │ └── css/ # 样式文件 │ └── style.css # 主样式文件 │ ├── docs/ # 文档 │ ├── api.md # API 文档 │ ├── architecture.md # 架构文档 │ ├── database.md # 数据库文档 │ ├── development.md # 开发文档 │ ├── nginx-config.md # Nginx 配置 │ ├── requirements.md # 系统要求 │ └── api-test.md # API 测试文档 │ ├── sql/ # 数据库文件 │ ├── schema.sql # 数据库结构 │ ├── fix.sql # 数据库修复 │ ├── add_apis.sql # API 数据 │ └── add_token_usage.sql # TOKEN使用记录 │ ├── lang/ # 语言包 │ └── install/ # 安装程序语言包 │ ├── zh-CN.php # 简体中文 │ └── en-US.php # 英文 │ ├── logs/ # 日志目录（自动创建） ├── config.php # 配置文件 ├── index.php # 入口文件 ├── diagnose.php # 诊断工具 ├── reset-admin.php # 重置管理员 ├── .gitignore # Git 忽略文件 └── README.md # 项目说明 ``` ## 安装教程 ### 环境要求 在安装之前，请确保您的服务器满足以下要求： - **PHP 版本**: 7.4 或更高版本 - **MySQL 版本**: 5.7 或更高版本 - **Web 服务器**: Apache 或 Nginx - **PHP 扩展**: - PDO_MySQL - mbstring - curl - json - openssl - **权限要求**: - logs/ 目录可写 - config.php 文件可写（安装期间） ### 安装步骤 #### 方式一：Web 安装向导（推荐） 1. **上传文件** - 将所有文件上传到您的 Web 服务器根目录 - 确保文件权限正确 2. **访问安装向导** - 在浏览器中访问 `http://您的域名/install.php` - 系统会自动检查环境是否满足要求 3. **配置数据库** - 填写数据库主机（通常为 localhost） - 填写数据库名称 - 填写数据库用户名和密码 - 点击测试连接 4. **设置管理员账户** - 设置管理员用户名 - 设置管理员密码 - 设置管理员邮箱 5. **完成安装** - 点击安装按钮 - 等待安装完成 - 删除 `install.php` 文件（安全考虑） #### 方式二：手动安装 1. **创建数据库** ```sql CREATE DATABASE apirhs CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ``` 2. **导入数据库结构** ```bash mysql -u用户名 -p密码 apirhs < sql/schema.sql ``` 3. **配置数据库连接** - 编辑 `config.php` 文件 - 填写数据库连接信息 4. **创建管理员账户** - 访问 `reset-admin.php` 创建管理员账户 - 或直接在数据库中插入管理员记录 5. **设置目录权限** ```bash chmod 755 logs/ chmod 644 config.php ``` ### Nginx 配置示例 ```nginx server { listen 80; server_name your-domain.com; root /var/www/apirhs; index index.php index.html; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } location ~ /\.ht { deny all; } } ``` ### Apache 配置示例 确保启用了 mod_rewrite 模块： ```apache Options Indexes FollowSymLinks AllowOverride All Require all granted ``` ## 使用说明 ### 前台使用 1. **注册账户** - 访问网站首页 - 点击注册按钮 - 填写注册信息 - 完成注册 2. **创建 API 密钥** - 登录用户中心 - 进入 API 密钥管理 - 点击创建新密钥 - 设置密钥名称和权限 3. **购买 TOKEN** - 进入 TOKEN 购买页面 - 选择充值套餐 - 选择支付方式 - 完成支付 4. **调用 API** - 使用您的 API 密钥调用 API - 系统自动扣除 TOKEN - 查看调用记录 ### 后台管理 1. **登录后台** - 访问 `/admin/` 目录 - 使用管理员账户登录 2. **管理用户** - 查看用户列表 - 编辑用户信息 - 管理用户权限 3. **配置支付** - 进入支付设置 - 配置翼支付参数 - 设置 TOKEN 兑换比例 4. **查看统计** - 查看收入统计 - 查看用户活跃度 - 导出数据报表 ### API 调用示例 ```php $apiKey, 'service' => 'service_name', 'params' => [] ]; $ch = curl_init($apiUrl); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Content-Type: application/json' ]); $response = curl_exec($ch); curl_close($ch); $result = json_decode($response, true); if ($result['code'] === 200) { echo 'API 调用成功'; echo '返回数据: ' . json_encode($result['data']); } else { echo 'API 调用失败: ' . $result['message']; } ?> ``` ## 系统配置 ### 配置文件说明 `config.php` 是系统的主要配置文件，包含以下配置项： ```php // 数据库配置 define('DB_HOST', 'localhost'); define('DB_NAME', 'apirhs'); define('DB_USER', 'root'); define('DB_PASS', 'password'); // 系统配置 define('APP_NAME', '创客API计费'); define('APP_URL', 'http://your-domain.com'); define('TOKEN_RATE', 100); // 1元 = 100 TOKEN // 支付配置 define('PAYMENT_ENABLED', true); ``` ### 环境变量 系统支持通过环境变量配置，创建 `.env` 文件： ``` DB_HOST=localhost DB_NAME=apirhs DB_USER=root DB_PASS=password APP_URL=http://your-domain.com ``` ## 安全建议 1. **删除安装文件** - 安装完成后立即删除 `install.php` - 删除 `reset-admin.php` 2. **设置强密码** - 管理员账户使用强密码 - 定期更换密码 3. **配置 HTTPS** - 使用 SSL 证书 - 强制 HTTPS 访问 4. **限制目录访问** - 保护敏感目录 - 配置 `.htaccess` 规则 5. **定期备份** - 定期备份数据库 - 备份重要文件 6. **更新系统** - 及时更新 PHP 版本 - 关注安全补丁 ## 常见问题 ### 安装问题 **Q: 提示数据库连接失败？** A: 检查数据库配置信息是否正确，确保数据库用户有足够权限。 **Q: 提示目录权限不足？** A: 确保 `logs/` 目录可写，使用 `chmod 755 logs/` 命令设置权限。 **Q: 安装后无法登录？** A: 检查浏览器是否支持 Cookie，清除浏览器缓存后重试。 ### 使用问题 **Q: TOKEN 扣除不准确？** A: 检查 API 服务价格设置是否正确，确保数据库字段支持小数。 **Q: 支付回调失败？** A: 检查支付网关配置，确保回调地址正确，查看日志文件排查问题。 **Q: API 调用返回错误？** A: 检查 API 密钥是否有效，TOKEN 余额是否充足，查看日志文件。 ## 更新日志 ### v1.0.0 (2026-02-18) - 初始版本发布 - 完整的用户管理系统 - API 密钥管理 - TOKEN 充值与消费 - 支付网关集成（翼支付/BestPay） - 后台管理系统 - 系统配置管理 - 支持小数计费（精确到小数点后4位） ## 技术支持 如有问题，请通过以下方式联系： - 提交 Issue: https://gitee.com/mksrc/apirhs/issues - 查看文档: https://gitee.com/mksrc/apirhs/wikis - 官方网站: https://www.mksrc.cn - QQ交流群: 712582610 ## 许可证 私有软件，未经授权不得复制或分发。 ## 致谢 感谢所有为本项目做出贡献的开发者。 --- **创客 API 计费系统** - 让 API 计费更简单