小小怪卡密系统文档

快速开始

小小怪卡密系统是一个功能强大、安全可靠的卡密验证系统，支持多种验证方式，提供完整的API接口。适用于软件授权、会员验证等场景。

系统环境要求

• PHP >= 7.0
• MySQL >= 5.7
• Apache/Nginx Web服务器

主要特点

• 支持时间卡密和次数卡密两种类型
• 安全的卡密存储机制（SHA1加密）
• 设备绑定与解绑功能
• 完善的管理后台
• 详细的API接口文档
• 高效稳定的性能

安装指南

步骤1: 获取源代码

从GitHub克隆项目到本地或服务器：

git clone https://github.com/xiaoxiaoguai-yyds/xxgkami.git

步骤2: 上传文件

将所有文件上传到您的Web服务器目录。

步骤3: 配置数据库

访问安装向导页面：

http://your-domain/install/

按照安装向导的步骤操作：

1. 填写数据库连接信息（主机名、用户名、密码、数据库名）
2. 设置管理员账号和密码
3. 配置系统基本参数

步骤4: 完成安装

安装完成后，系统会自动创建所需的数据表和初始配置。您可以使用设置的管理员账号登录后台。

API 文档

小小怪卡密系统提供了完整的RESTful API接口，方便开发者集成到自己的应用中。

验证卡密 API

接口地址： /api/verify.php

请求方式： POST/GET

接口说明： 验证卡密的有效性，支持设备绑定。

请求参数

响应示例 (时间卡)

{
    "code": 0,
    "msg": "验证成功",
    "data": {
        "card_id": 123,
        "card_type": "time",
        "expire_time": "2024-12-31 23:59:59",
        "create_time": "2024-01-01 00:00:00",
        "status": 1
    }
}

响应示例 (次数卡)

{
    "code": 0,
    "msg": "验证成功",
    "data": {
        "card_id": 456,
        "card_type": "count",
        "total_count": 100,
        "remaining_count": 99,
        "create_time": "2024-01-01 00:00:00",
        "status": 1
    }
}

错误码说明

PHP调用示例

// POST请求示例
$url = 'http://your-domain/api/verify.php';
$data = [
    'card' => '用户输入的卡密',
    'device_id' => '设备唯一标识'
];

$options = [
    'http' => [
        'header' => "Content-type: application/x-www-form-urlencoded\r\n",
        'method' => 'POST',
        'content' => http_build_query($data)
    ]
];

$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
$response = json_decode($result, true);

if ($response['code'] == 0) {
    // 卡密验证成功
    if ($response['data']['card_type'] == 'time') {
        echo "验证成功，到期时间: " . $response['data']['expire_time'];
    } else {
        echo "验证成功，剩余次数: " . $response['data']['remaining_count'];
    }
} else {
    // 验证失败
    echo "验证失败: " . $response['msg'];
}

卡密类型说明

小小怪卡密系统支持两种类型的卡密：时间卡密和次数卡密。

时间卡密

时间卡密基于时间段进行验证，特点如下：

• 首次验证时开始计时
• 可设置有效期（天数）
• 过期后无法继续使用
• 支持设置永久卡密（duration=0）

次数卡密

次数卡密基于使用次数进行验证，特点如下：

• 每次验证消耗一次使用次数
• 可设置总使用次数
• 次数用完后无法继续使用
• 不受时间限制

管理后台使用

管理后台提供了完整的卡密管理、统计分析功能。

登录后台

访问后台登录页面：

http://your-domain/admin.php

使用在安装时设置的管理员账号和密码登录。

卡密管理

生成卡密

1. 在后台点击"卡密管理" > "生成卡密"
2. 选择卡密类型（时间卡/次数卡）
3. 设置卡密参数（数量、时长/次数等）
4. 点击"生成"按钮

查询卡密

1. 在后台点击"卡密管理" > "卡密列表"
2. 使用搜索框查找特定卡密
3. 查看卡密详细信息

管理卡密

在卡密列表中，您可以进行以下操作：

• 启用/禁用卡密
• 解绑设备
• 修改卡密信息
• 删除卡密

数据统计

后台提供详细的数据统计功能，包括：

• 卡密使用趋势图
• 卡密状态分布
• API调用统计
• 设备分布

系统设置

在"系统设置"中，您可以配置以下选项：

• 卡密验证设置（是否允许同一设备重复验证）
• API接口设置
• 管理员密码修改
• 系统备份

常见问题

Q: 如何更改卡密绑定的设备？

A: 管理员可在后台的卡密列表中，找到对应卡密，点击"解绑设备"按钮。解绑后，该卡密可以重新绑定新设备。

Q: 如何实现永久有效的卡密？

A: 生成时间卡密时，将有效期设置为0，系统会将其视为永久卡密。

Q: 系统支持批量导入卡密吗？

A: 目前系统不支持直接批量导入，但您可以通过后台批量生成功能创建大量卡密。

Q: 如何升级系统？

A: 请参考系统升级部分的说明，按照步骤进行升级。升级前务必备份数据库。

Q: 能否自定义错误提示信息？

A: 可以通过修改源代码中的相关文件实现自定义错误提示。主要修改位于api目录下的文件。