多语言源码对接

01快速开始（三步）

02两种对接方式

智链同时支持「源码对接加密」与「API 加密」。前者由加密端完成加壳与登录验证，后者由你的程序直接调用开放接口，两者共用同一套应用、卡密与授权数据。

03协议总览

统一入口：POST {服务端地址}/api/open，Content-Type: application/json。

请求体

{
  "app_uuid":  "应用 UUID",
  "api_type":  接口号（整数）,
  "algorithm": 0 = 明文 / 1 = AES-256-GCM / 2 = ChaCha20-Poly1305,
  "data":      "按 algorithm 加密后的参数 JSON（base64）",
  "timestamp": 当前 Unix 秒,
  "sign":      签名（方案 1 时填随机 nonce）
}

签名方案

• 方案 0（对称）：sign = SHA256("app_uuid|api_type|algorithm|data|timestamp|secret")，结果转大写 hex。
• 方案 1（Ed25519）：请求不签名，sign 填 32 位随机 hex nonce（服务端做时间窗 + 防重放）；响应携带 ed_sign 供客户端用公钥验签。

密文格式（两种算法相同）

base64( 12 字节随机 nonce + 密文 + 16 字节 tag )，密钥为 32 字节（64 位 hex）。请求与响应使用同一算法、同一密钥。

响应体与验签

// code：0=成功 / 2=强制更新拦截 / 其他=失败
{ "code": 0, "data": "加密结果（同请求算法）", "msg": "", "timestamp": "Unix 秒", "sign" / "ed_sign": "" }

// 响应验签（方案 0）：SHA256("code|data|msg|timestamp|secret") 大写 hex
// 响应验签（方案 1）：Ed25519_verify(public_key, "code|data|msg|timestamp")

0421 种语言清单

每种语言都提供完整示例：签名（含 algorithm）+ AES / ChaCha20 加解密 + 统一调用。标 已实测 的已在真实服务器验证「获取公告 / 公开效验 / 版本检测 / 更新地址」并完成响应验签。

05目录结构

SDK 按语言分目录，每个目录自带配置区、加密实现与一个可运行的演示入口：

Zhi_Lian_i_SDK/
├─ python/               go/                java/
├─ C#/                   C/                 C++/
├─ rust/                 zig/               nim/
├─ swift/                kotlin/            php/
├─ delphi/               lazarus/           lua/
├─ purebasic/            aardio/            javascript-typescript/
├─ lanren/               anjian/            Zhi_Lian_i_SDK/
└─ README.md             # 协议说明与各语言运行方式

06接口清单

以下 37 个接口与服务端 dispatch 一致。所有接口都走 /api/open，只需改 api_type 与 data 内的参数。

基础信息

卡密与账号

会话与状态

云函数与安全

授权 · 点数 · 支付

自定义内容

仅后台

注：23 / 24 / 25 仅限管理后台操作，服务端会拒绝客户端调用，避免持有应用密钥的程序越权封停或扣减任意账号。旧 IP 转绑接口（52）已废弃，统一并入转绑（21）。

07安全建议

• 生产环境必须使用加密算法（1 或 2），明文仅限本地调试；服务端可按应用禁用明文。
• 有条件优先用方案 1（Ed25519）：请求不带可伪造的对称签名，Secret 不参与请求签名。
• 机器码务必在客户端真实采集，示例中是占位值。
• 扣点（28）务必带 biz_no 幂等标记，防止网络重试导致重复扣费。
• 响应的 ed_sign / sign 验签建议保留，能及时发现中间人篡改。

08常见问题

提示「当前应用未允许明文传输」

应用已禁用明文，把 algorithm 改为 1 或 2。

「请求解密失败」

检查密钥 hex 是否完整（64 位）、密文是否为 nonce + 密文 + tag 完整拼接。

「会话无效或已被顶号」

token 失效（过期 / 被顶 / 已退出），重新登录。

「请求已处理，请勿重复提交」

防重放命中（nonce 重复或时间窗外），重新生成 sign。

C / C++ 运行报缺 DLL

libcurl-x64.dll 需与 exe 同目录，build.sh 会自动复制。

09征稿计划