CONTROL ROOM
总览
A管理员
运营概览
充值卡和余额账户的实时状态。
账户总数0已创建的充值账户
可用卡密0等待兑换
已使用卡密0累计兑换成功
今日充值¥0.00今日余额入账
最近充值
最新的余额变动记录
快捷操作
常用管理入口
充值卡密
创建并管理可兑换余额的卡密。
账户充值
使用充值卡密为指定账户增加余额。
兑换充值卡
充值成功后卡密将立即失效。
当前账户余额¥0.00
选择账户后显示余额
充值操作会自动生成余额流水，便于后续核对。
账户管理
维护可使用充值卡的余额账户。
Telegram 用户
用户点击 Bot 开始后会自动登记，余额与 Bot 实时共用。
Bot 配置
集中管理 Telegram Bot、短信接口和计费参数。
运行配置
敏感字段留空时保持原值；保存后重启 Bot 生效。
平台账户余额—
点击刷新查询
余额流水
所有充值入账记录，支持追溯核对。
API 接入文档
业务系统通过服务端接口安全兑换卡密并为账户充值。
服务地址
—鉴权请求头
X-API-Key数据格式
application/json对接密钥
检查中
接口说明
当前公开接口用于将有效卡密兑换至指定账户。接口只应从你的业务服务端调用，不要在网页、App 或脚本客户端中保存对接密钥。
POST
/api/v1/recharge身份认证
每次请求都必须通过 X-API-Key 请求头传入后台环境变量 INTEGRATION_API_KEY 对应的密钥。
注意后台仅显示密钥是否配置，不会读取或回显真实值。修改后台
.env 后需要重启服务。卡密充值
校验卡密状态并将面额加入目标账户余额。成功后卡密立即标记为已使用。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
username | string | 是 | 后台中已存在的账户名称 |
cardCode | string | 是 | 待兑换的充值卡密，不区分字母大小写 |
成功响应 200
{
"success": true,
"user": {
"id": "u_example",
"username": "user_001",
"balance": 110
},
"transaction": {
"id": "txn_example",
"type": "recharge",
"amount": 10,
"beforeBalance": 100,
"afterBalance": 110,
"operator": "integration"
}
}错误处理
失败响应统一返回 JSON，客户端应同时判断 HTTP 状态码与 error 字段。
{ "error": "卡密不存在或输入错误" }| 状态码 | 含义 | 常见原因 |
|---|---|---|
| 400 | 请求不可处理 | 缺少参数、卡密已使用、已禁用或已过期 |
| 401 | 鉴权失败 | X-API-Key 缺失或不正确 |
| 404 | 资源不存在 | 账户不存在或卡密错误 |
| 503 | 接口未启用 | 服务端尚未配置 INTEGRATION_API_KEY |
安全要求
- 仅通过 HTTPS 在公网调用接口。
- 密钥只保存在业务服务端环境变量中，禁止提交到代码仓库。
- 充值请求成功后不要自动重试；网络超时时应先核对账户余额或流水，避免重复业务操作。
- 定期轮换高强度随机密钥，并限制调用服务器的网络访问范围。