// CARD MANAGEMENT
卡密管理
已选 0
| 卡密 | 天数 | 机器码 | 激活时间 | 到期时间 | 状态 | 剩余 |
|---|
勾选行首复选框可多选，配合右上「批量解绑 / 批量删除」批量操作；右键单张卡密可呼出菜单（详情 / 解绑 / 删除）。
// CLOUD VARIABLES
云变量
已选 0
| 变量名 | 内容 | 更新时间 | 操作 |
|---|
// NOTICE
公告
// API DOCUMENTATION
接口对接文档
以下均为 GET 请求（部分支持 POST 表单 / JSON Body）。除密钥接口外，其余接口都必须携带
key 参数，值为当前动态密钥（见「密钥接口」）。下方 你的域名 需替换为实际域名。一、密钥接口GET
所有业务接口（卡密 / 云变量 / 公告）的鉴权都依赖当前动态密钥。密钥每分钟变化一次，由 SHA256 计算生成。
① 获取当前密钥
GET http://你的域名/api/key/getkey.php
| 参数 | 必填 | 说明 |
|---|---|---|
| key | 否 | 可加可不加（可选参数，用于兼容旧调用），不校验 |
返回（纯文本）
3f2a9b1c7d8e4f5a6b7c8d9e0f1a2b3c
② 刷新当前密钥
GET http://你的域名/api/key/update_key.php
强制重新生成当前分钟的密钥并写入密钥文件。可被 cron 每分钟调用，也可手动触发。
返回（纯文本）
已更新 2026-09-25 20:00:00 -> 3f2a9b1c7d8e4f5a6b7c8d9e0f1a2b3c
二、卡密接口（api/login.php）GET / POST
卡密的新增、解绑、删除、查询、列表、统计、登录。公共参数：
key（必填，接口密钥）、action（必填，操作类型）。① 新增卡密 add
GET http://你的域名/api/login.php?key=KEY&action=add&days=30&count=10
| 参数 | 必填 | 说明 |
|---|---|---|
| days | 是 | 天数，大于 0 的整数 |
| count | 否 | 生成数量，默认 1，范围 1 ~ 1000 |
{ "code":200, "msg":"生成成功", "data":{ "days":30, "count":10, "cards":["ABCDEFGHJKLMNPQRSTUVWX1234567890", ...] } }
② 解绑 unbind
GET http://你的域名/api/login.php?key=KEY&action=unbind&card=卡密&reset=1
| 参数 | 必填 | 说明 |
|---|---|---|
| card | 是 | 卡密 |
| reset | 否 | 传 1 时同时重置激活 / 到期时间 |
③ 删除卡密 delete
GET http://你的域名/api/login.php?key=KEY&action=delete&card=卡密
④ 查询单卡 info
GET http://你的域名/api/login.php?key=KEY&action=info&card=卡密
⑤ 卡密列表 list（分页 + 关键字）
GET http://你的域名/api/login.php?key=KEY&action=list&page=1&size=20&keyword=ABC
| 参数 | 必填 | 说明 |
|---|---|---|
| page | 否 | 页码，默认 1 |
| size | 否 | 每页条数，默认 20，最大 500 |
| keyword | 否 | 按卡密 / 机器码模糊搜索 |
{ "code":200, "msg":"ok", "data":{ "total":120, "page":1, "size":20, "pages":6, "items":[ { "card":"...", "days":30, "machine":"", "state":"unused", ... } ] } }
⑥ 按天数统计 stats
GET http://你的域名/api/login.php?key=KEY&action=stats
⑦ 卡密登录 / 激活 login（供客户端软件调用）
GET http://你的域名/api/login.php?key=KEY&action=login&card=卡密&machine=机器码
首次登录自动激活并计算到期时间；机器码不匹配 / 已过期会返回对应错误码。管理端界面不提供此项。
三、云变量接口（api/cloud_vars.php）GET / POST / JSON
自定义变量的新增、修改、读取、删除、列表。公共参数：
key（必填）、action（必填）。① 读取 get / read
GET http://你的域名/api/cloud_vars.php?key=KEY&action=get&name=greeting
加
&format=raw 直接返回纯文本内容，适合网页直接展示。② 新增 / 修改 set（有则改、无则增）
GET http://你的域名/api/cloud_vars.php?key=KEY&action=set&name=greeting&value=你好
| 参数 | 必填 | 说明 |
|---|---|---|
| name | 是 | 变量名，字母 / 数字 / 下划线 / 中划线 / 点 / 中文 |
| value | 是 | 变量内容，最大 1 MB |
| unescape | 否 | 1 时把字面量 \n 还原为真实换行 |
③ 仅新增 add（已存在则报错） / 仅修改 update（不存在则报错）
GET http://你的域名/api/cloud_vars.php?key=KEY&action=add&name=x&value=1
④ 删除 delete / del
GET http://你的域名/api/cloud_vars.php?key=KEY&action=delete&name=greeting
⑤ 列表 list / all
GET http://你的域名/api/cloud_vars.php?key=KEY&action=list&full=1
full=1 返回全部变量名与内容；省略则只返回变量名列表。四、公告接口（api/notice.php）GET
公告的读取与写入。同样使用动态密钥鉴权。
① 读取公告 read
GET http://你的域名/api/notice.php?action=read&key=KEY
② 写入公告 write
GET http://你的域名/api/notice.php?action=write&key=KEY&content=新的公告内容
{ "code":1, "msg":"修改成功" }
五、管理员接口（api/admin_auth.php）GET / POST
管理端登录与会话、新建 / 删除管理员。此接口不校验动态密钥，改用会话（Cookie）鉴权；新建 / 列表 / 删除仅超级管理员可调用。
① 登录 login
GET http://你的域名/api/admin_auth.php?action=login&username=admin&password=666@xinyi
| 参数 | 必填 | 说明 |
|---|---|---|
| username | 是 | 账号 |
| password | 是 | 密码 |
{ "code":200, "msg":"登录成功", "data":{ "username":"admin", "role":"super", "is_super":true } }
② 会话校验 check
GET http://你的域名/api/admin_auth.php?action=check
判断当前是否已登录，返回账号与角色。
③ 退出 logout
GET http://你的域名/api/admin_auth.php?action=logout
④ 新建管理员 create_admin（仅超级管理员）
GET http://你的域名/api/admin_auth.php?action=create_admin&username=张三&password=123456&role=admin
| 参数 | 必填 | 说明 |
|---|---|---|
| username | 是 | 新账号（2 ~ 32 字符） |
| password | 是 | 新密码（至少 6 位） |
| role | 否 | super（超管）或 admin（普通），默认 admin |
⑤ 管理员列表 list_admins（仅超级管理员）
GET http://你的域名/api/admin_auth.php?action=list_admins
⑥ 删除管理员 delete_admin（仅超级管理员）
GET http://你的域名/api/admin_auth.php?action=delete_admin&username=张三
⑦ 修改密码 change_password
GET http://你的域名/api/admin_auth.php?action=change_password&old_password=旧密码&new_password=新密码
默认修改本人（需校验旧密码）；超级管理员可在
username 指定他人账号代改。