授权中心 API
IDC 客户端通过以下接口完成授权校验、心跳、版本更新、插件安装与公告同步。
接入信息
接口根地址
https://cool.30y.cn/index.php数据格式
application/json / x-www-form-urlencoded鉴权方式
授权码 code + 管理员 API Token所有响应均包含 ok 字段与 message;失败时 ok=false,可直接在 IDC 后台展示 message。管理员 Token 在后台「API 令牌」页生成。
接口列表
| 方法 | 路径 | 名称 | 说明 |
|---|---|---|---|
| POST | index.php?r=api/license/verify | 授权校验 | 提交 code + domain,返回授权状态、版本、绑定站点列表与下载地址;首次校验自动绑定域名,未达站点上限时新站点自动加入绑定。 |
| POST | index.php?r=api/license/heartbeat | 心跳上报 | 每 6~24 小时上报一次 code + domain + ip(建议附带 sig=HMAC(CODE|host|ts) 与 ts 时间戳防篡改),失败/被吊销会立即返回错误,用于在线吊销。 |
| POST | index.php?r=api/license/offline | 离线授权文件 | 返回带 HMAC-SHA256 签名的 JSON 授权文件,可在内网/无外网环境校验。 |
| POST | index.php?r=api/program/version | 版本检测 | 返回最新版本、发布渠道、强制更新标记、安装包哈希与下载地址。 |
| GET | index.php?r=api/program/download&code=xxx | 系统包下载 | 校验授权码后下载系统安装包。 |
| POST | index.php?r=api/store/plugins | 商城插件列表 | 返回插件依赖、试用天数、兼容版本范围与下载地址。 |
| GET | index.php?r=api/store/download&code=xxx&slug=yyy | 插件包下载 | 校验授权码后下载插件安装包。 |
| POST | index.php?r=api/announcements | 公告拉取 | 返回最新公告与版本更新,IDC 后台可同步展示。 |
| POST | index.php?r=api/license/revoke | 吊销授权(管理员) | 需携带 X-API-Token;支持单码吊销、批量吊销与恢复。 |
| POST | index.php?r=api/payment/callback | 支付回调 | 第三方支付成功回调:校验订单号/金额/签名后将订单标记为已支付并写入支付流水。 |
校验返回示例
{
"ok": true,
"message": "授权校验通过",
"license": {
"code": "XY-8F2A-91CD-4E7B-6K3M",
"plan": "standard",
"plan_name": "标准版",
"edition": "V3正式版",
"channel": "stable",
"system_version": "3.0.0",
"expires_at": "2027-11-09 12:00:00",
"domain": "idc.30y.cn",
"force_update": false,
"download_url": "https://cool.30y.cn/index.php?r=api/program/download&code=..."
}
}
在线支付对接(码支付 / 易支付)
收银台默认取后台「站点设置 → 在线支付」的配置。码支付使用 gateway + pid + key,支持支付宝、微信、QQ 钱包;异步通知地址如下(换域名会自动跟随 site_url):
https://cool.30y.cn/index.php?r=api/payment/callback
回调字段:pid / trade_no / out_trade_no / type / name / money / trade_status / sign / sign_type;trade_status=TRADE_SUCCESS 视为支付成功,系统校验 sign 与订单金额后自动开通授权(新购、续费、升级、插件同一套回调)。
码支付签名(官方算法): sign = md5(pid + type + out_trade_no + notify_url + return_url + name + money + sign_type + key) 易支付签名(彩虹易支付): sign = md5(参数按 key 升序拼接为 k=v&... + key)
离线授权文件校验
离线授权文件为 JSON,字段 signature 为其余字段按 JSON 序列化后的 HMAC-SHA256 值。校验方使用授权中心后台「离线授权密钥」进行签名比对,并检查 expires_at 与 domain。