🔐 三零云 授权中心

授权中心 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。