PHP 单文件 SDK

下载 idcgo-license.php.txt 并重命名为 idcgo-license.php， 放到你的系统授权文件中 require；licenseRequest() 已封装 JSON 提交、超时与错误归一，licenseVerifySign() 用于校验返回体签名。

require 'idcgo-license.php';

$res = licenseRequest('/verify', [
    'license_key' => 'IDCG-XXXX-XXXX-XXXX-XXXX',
    'domain'      => 'demo.example.com',
]);

if (($res['code'] ?? -1) !== 0) {
    exit($res['message'] ?? '授权校验失败');
}

if (! licenseVerifySign($res['data'], '你的 LICENSE_SIGN_SALT')) {
    exit('返回体签名不合法');
}

通用资源（SDK / OpenAPI / 公开查询）统一列在 文档总览，本页不再重复。

授权服务端会在激活、在线校验时自动识别请求的出口公网 IP，写入绑定记录与校验日志， 并在成功响应里返回 server_ip。客户端不需要读取网卡，也不需要手动上报 IP。

公开查询页 /check 也支持直接输入域名或服务器 IP， 返回该 IP 最近一次校验对应的授权，便于客服或用户自助核对。后台侧检测见 用户中心 API · 服务器 IP 检测。

域名 + IP 双重校验

绑定域名时填写的服务器 IP 会被锁定为该绑定记录的校验基准。之后每次 /activate、/verify， 服务端都会拿请求域名与本次请求的出口 IP 逐项比对，域名与 IP 必须同时匹配才放行。

{
  "code": 1014,
  "message": "服务器 IP 与绑定不一致（绑定 38.76.166.40，当前 112.48.82.6），请在用户中心重新绑定后再试",
  "data": null
}

IP 检测接口

客户端可以在启动时调用 GET /v1/ip 获取自己的出口公网 IP，用于展示或排查网络问题。 该接口不校验授权，限流与其它接口一致。

curl "https://api.idcxb.com/api/v1/ip"

{
  "code": 0,
  "message": "ok",
  "data": {
    "ip": "38.76.166.40",
    "remote_ip": "38.76.166.40",
    "version": "IPv4",
    "public": true,
    "forwarded": false,
    "detected_at": "2026-10-28 22:10:00"
  }
}

同时，/activate 与 /verify 的成功响应也会带回 server_ip， 客户端可以缓存并在后台展示，方便和用户核对。

GET https://api.idcxb.com/api/v1/ping

不校验任何参数，用于部署后确认授权服务器可达。

curl "https://api.idcxb.com/api/v1/ping"

{
  "code": 0,
  "message": "ok",
  "data": {
    "server_time": "2026-10-27 20:18:00",
    "server_ip": "38.76.166.40",
    "server_ip_version": "IPv4"
  }
}

POST https://api.idcxb.com/api/v1/activate

把授权码绑定到当前部署的域名，服务端会校验该域名当前解析到的 IP 与请求出口 IP 是否一致，并一并锁定。首次部署时调用一次，成功后把结果缓存到本地。

curl -X POST "https://api.idcxb.com/api/v1/activate" \
  -d "license_key=IDCG-ABCD-EFGH-JKLM-NPQR" \
  -d "domain=demo.example.com"

{
  "code": 0,
  "message": "激活成功",
  "data": {
    "license_key": "IDCG-ABCD-EFGH-JKLM-NPQR",
    "domain": "demo.example.com",
    "status": "active",
    "status_text": "正常",
    "permanent": false,
    "activated_at": "2026-10-27 20:18:00",
    "expires_at": "2027-10-27 20:18:00",
    "days_left": 365,
    "max_activations": 1,
    "activation_count": 1,
    "verify_interval_minutes": 1,
    "offline_grace_hours": 72,
    "server_ip": "38.76.166.40",
    "server_ip_version": "IPv4",
    "server_time": "2026-10-27 20:18:00",
    "sign": "…"
  }
}

POST https://api.idcxb.com/api/v1/verify

建议每 1 分钟调用一次。license_key 与 domain 都必填， 服务端会同时核对域名和请求出口 IP，任一项不一致即返回 1014。

curl -X POST "https://api.idcxb.com/api/v1/verify" \
  -d "license_key=IDCG-ABCD-EFGH-JKLM-NPQR" \
  -d "domain=demo.example.com"

{
  "code": 0,
  "message": "ok",
  "data": {
    "license_key": "IDCG-ABCD-EFGH-JKLM-NPQR",
    "domain": "demo.example.com",
    "status": "active",
    "status_text": "正常",
    "permanent": false,
    "expires_at": "2027-10-27 20:18:00",
    "days_left": 365,
    "max_activations": 1,
    "activation_count": 1,
    "verify_interval_minutes": 1,
    "offline_grace_hours": 72,
    "server_ip": "38.76.166.40",
    "server_ip_version": "IPv4",
    "server_time": "2026-10-27 20:18:00",
    "sign": "…"
  }
}

POST https://api.idcxb.com/api/v1/deactivate

迁移服务器或更换域名时调用，释放一个域名名额。license_key 与 domain 都必填。

curl -X POST "https://api.idcxb.com/api/v1/deactivate" \
  -d "license_key=IDCG-ABCD-EFGH-JKLM-NPQR" \
  -d "domain=demo.example.com"

成功时返回 code=0，message 为「解绑成功」。 子域名需要单独绑定与解绑，解绑时按域名精确匹配。

不想写代码、或者想把授权交给客户自己完成时，直接用链接授权： 把带授权码的链接发给对方，打开后填上域名、点一下「确认授权」就好了。

# 网页版：打开就能填域名，适合直接发给客户
https://api.idcxb.com/activate?key=IDCG-ABCD-EFGH-JKLM-NPQR&domain=demo.example.com

# 接口版：GET 直接返回 JSON，适合脚本 / 命令行
curl "https://api.idcxb.com/api/v1/activate?license_key=IDCG-ABCD-EFGH-JKLM-NPQR&domain=demo.example.com"

在链接后面加一个 callback，授权成功后会 302 跳回这个地址， 并把授权信息一并带过去。你的程序在那个入口验签、落库即可，客户全程不用复制粘贴。

# 授权成功后跳回 https://demo.example.com/license-callback
https://api.idcxb.com/activate?key=IDCG-ABCD-EFGH-JKLM-NPQR&domain=demo.example.com&callback=https://demo.example.com/license-callback

客户程序端的接收示例：

// /license-callback.php —— 放在你自己的站点上
$payload = $_GET['payload'] ?? '';
$sign    = $_GET['sign'] ?? '';

// 1. 验签，防止参数被篡改
$expect = hash_hmac('sha256', $payload, '你的签名盐值');
if (! hash_equals($expect, $sign)) {
    exit('签名校验失败');
}

// 2. 解开授权信息
$license = json_decode(base64_decode($payload), true);

// 3. 写入自己的配置或数据库
file_put_contents(__DIR__ . '/license.json', json_encode($license, JSON_UNESCAPED_UNICODE));

header('Location: /admin?licensed=1');

激活（PHP cURL）：

// 首次部署时调用一次，成功后把结果缓存到本地
$payload = [
    'license_key' => 'IDCG-ABCD-EFGH-JKLM-NPQR',
    'domain'      => $_SERVER['HTTP_HOST'],
];

$ch = curl_init('https://api.idcxb.com/api/v1/activate');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query($payload),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 8,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

if (($res['code'] ?? -1) !== 0) {
    die('授权校验失败：' . ($res['message'] ?? '未知错误'));
}
// $res['data'] 内含到期时间、可绑定数量、服务器 IP 等

定时校验（建议放进计划任务，每 1 分钟一次）：

// 校验失败时不要立刻停机，先看离线宽限期
$res = post('https://api.idcxb.com/api/v1/verify', $payload);

if (($res['code'] ?? -1) === 0) {
    cache_set('license_ok_at', time());
} elseif (time() - cache_get('license_ok_at') > 72 * 3600) {
    // 超出 72 小时宽限期，才真正停用
    die('授权已失效：' . $res['message']);
}

返回体的 data 中带有一个 sign 字段，是对除 sign 外所有字段 按键名排序后做 JSON 编码、再用签名盐值做 HMAC-SHA256 得到的。客户端用同样的方式重算一次即可确认结果未被篡改。

function verifySign(array $data, string $salt): bool
{
    $sign = $data['sign'] ?? '';
    unset($data['sign']);
    ksort($data);

    $expect = hash_hmac('sha256', json_encode($data, JSON_UNESCAPED_UNICODE), $salt);

    return hash_equals($expect, $sign);
}

• 激活成功后把 data 缓存到本地，避免每次启动都重新激活。
• 校验间隔使用接口返回的 verify_interval_minutes，不要写死。
• 校验失败先走 offline_grace_hours 宽限，不要立即停机。
• 每次成功响应都验签，确认 sign 与本地重算结果一致。
• 迁移服务器前先调用 /deactivate 释放旧域名，避免触发绑定上限。
• 服务器 IP 以调用方出口 IP 为准，客户端无需读取网卡；绑定域名时需确保域名解析到该 IP。
• 子域名需要单独绑定，根域名不会自动覆盖子域名。
• 日志里不要记录完整授权码，展示时至少打码中间两段。

GET https://api.idcxb.com/api/v1/check?q=example.com

无需登录即可核验授权真伪，与官网「授权查询」页面同一套判断逻辑，适合放在客户官网、帮助中心或工单页。 传域名会精确匹配已绑定的域名，传服务器 IP 会匹配绑定记录里的 IP，传授权码则直接查该授权。 每个 IP 每分钟 30 次。

curl "https://api.idcxb.com/api/v1/check?q=example.com"

{
  "code": 0,
  "message": "ok",
  "data": {
    "query": "example.com",
    "type": "domain",
    "found": true,
    "license": {
      "masked_key": "IDCG-****-****-****-8F2K",
      "status": "active",
      "status_label": "授权有效",
      "status_note": null,
      "expires_at": "2027-10-27 20:18:00",
      "days_left": 363,
      "max_activations": 3,
      "active_count": 1,
      "matched_domain": "example.com",
      "covered_by": null,
      "binding_text": "example.com"
    }
  }
}