接入文档

只需四步即可完成接入：

最小可运行示例（PHP）

<?php
require 'sdk/php/AuthClient.php';

// 参数：授权码, 应用密钥, 接口地址, 超时, 应用标识
$client = new AuthClient('你的授权码', '你的APP_SECRET', 'https://auth.chipzx.com/api/license.php', 10, 'app_xxxxxxxx');

$res = $client->verify([
    'domain'    => $_SERVER['HTTP_HOST'],   // 或填写服务器 IP
    'cache_ttl' => 300,                     // 5 分钟内复用结果
]);
if ($res['status'] !== 1) {
    exit('授权校验失败：' . $res['msg']);
}

// 可选：检查在线更新
$up = $client->checkUpdate('1.0.0');
if (!empty($up['data']['has_update'])) {
    // 提示用户升级……
}
// 校验通过，继续执行业务逻辑……

我们为常见语言提供了开箱即用的接入 SDK，均已内置签名、时间戳与缓存逻辑，直接引入即可使用。

请求地址

POST  https://auth.chipzx.com/api/license.phpContent-Type: application/x-www-form-urlencoded

请求参数

响应格式

{
  "code": 1000,
  "status": 1,
  "msg": "授权有效",
  "data": {
    "license_key":  "CZX-XXXX-XXXX-XXXX",
    "app_id":       1,
    "app_name":     "示例应用",
    "product_id":   1,
    "bind_domain":  "example.com",
    "bind_ip":      "1.2.3.4",
    "status":       1,
    "active_at":    "2026-01-01 00:00:00",
    "expire_at":    "2026-12-31 23:59:59",
    "remain":       "剩余 364 天",
    "is_forever":   false,
    "server_time":  "2026-01-01 12:00:00",
    "sign":         "A1B2C3..."      // 数据签名，防篡改
  },
  "server_time": "2026-01-01 12:00:00",
  "timestamp": 1767225600
}

签名用于防篡改，规则如下（与主流支付网关一致，便于各语言实现）：

1. 取除 sign 外的所有请求参数；
2. 按下标（参数名）ASCII 升序排列；
3. 剔除值为空的参数；
4. 拼接成 k1=v1&k2=v2&… 的字符串；
5. 末尾追加 &key=APP_SECRET（该应用的应用密钥）；
6. 对结果取 MD5，并转为大写即为 sign。

// 示例：app_id=app_demo0001、license_key=L1、domain=demo.com、ip=1.2.3.4、
//       timestamp=1700000000、nonce=n1
// 去空排序拼接后：
app_id=app_demo0001&domain=demo.com&ip=1.2.3.4&license_key=L1&nonce=n1&timestamp=1700000000&key=你的APP_SECRET
// 取 MD5 转大写：
sign = MD5(上面的字符串).toUpperCase()

多语言签名实现

// ---------- PHP ----------
$params = ['app_id'=>$aid,'license_key'=>$lic,'domain'=>$dom,'ip'=>$ip,'timestamp'=>time(),'nonce'=>$n];
ksort($params);
$params = array_filter($params, fn($v) => $v !== '' && $v !== null);
$sign = strtoupper(md5(http_build_query($params).'&key='.$appSecret));

// ---------- Python ----------
params = {'app_id':aid,'license_key':lic,'domain':dom,'ip':ip,'timestamp':int(time.time()),'nonce':n}
params = {k: v for k, v in params.items() if v not in ('', None)}
raw = '&'.join('%s=%s' % (k, params[k]) for k in sorted(params))
sign = hashlib.md5((raw + '&key=' + app_secret).encode()).hexdigest().upper()

// ---------- C ----------
// 依次拼接 app_id、domain、ip、license_key、nonce、timestamp（空值省略），
// 末尾追加 "&key=APP_SECRET"，调用 czx_md5_upper 转大写

对于无法联网（内网/隔离环境）部署的场景，可使用基于 RSA-SHA256 数字签名 的离线授权码，在本地完成验签，无需联网。

1. 在 我的授权 页面点击「生成离线授权码」，得到一个 Base64 字符串；
2. 将离线授权码与平台公钥一并内置到你的程序中；
3. 程序启动时，用公钥对离线授权码验签，通过后即可放行，同时校验其中的域名/IP 与到期时间。