ZhilianSDK 接入文档

#include <stdio.h>

int main(void) {
    void* h = ZL_Create();
    if (!h) return 1;

    // ① 配置：粘贴后台「一键生成对接参数」里的整串
    if (ZL_SetConfig(h, "这里粘贴 product_token") != 0) {
        char err[512];
        ZL_GetLastErrorMessage(h, err, sizeof(err));
        printf("配置失败: %s\n", err);
        return 1;
    }

    // ② 卡密登录
    int r = ZL_CardLogin(h, "你的卡密");
    if (r != 0) {
        char err[512];
        ZL_GetLastErrorMessage(h, err, sizeof(err));
        printf("登录失败: %s\n", err);
        ZL_Destroy(h);
        return 1;
    }

    // ③ 开启自动心跳（默认是关的，建议打开）
    ZL_SetAutoHeartbeat(h, 1, 0);

    // ④ 取数据
    char buf[65536];
    ZL_GetExpire(h);
    ZL_GetResult(h, buf, sizeof(buf));
    printf("到期信息: %s\n", buf);

    ZL_Logout(h);
    ZL_Destroy(h);
    return 0;
}

ZL_SetConfig(h, "后台复制的那一整串");

ZL_Create()                 创建实例，拿到句柄
      │
ZL_SetConfig(对接串)         配置（一次性）
      │
ZL_SetAutoHeartbeat(1, 0)   开自动心跳（建议）
      │
ZL_CardLogin(卡密)           登录 → 成功返回 0
      │  └─ 失败：ZL_GetLastErrorMessage 取原因
      │
   ┌──┴──────────────────────┐
   │  业务调用                │
   │  ZL_GetExpire            │
   │  ZL_GetNotice            │
   │  ZL_GetVariable          │
   │  ZL_PointsDeduct         │
   │  ...                     │
   └──┬──────────────────────┘
      │
ZL_Logout()                 退出登录
      │
ZL_Destroy()                销毁实例（自动停心跳、释放资源）

char buf[65536];
int r = ZL_GetExpire(h);
if (r == 0) {
    ZL_GetResult(h, buf, sizeof(buf));
    // buf 里是 JSON，例如：
    // {"code":0,"data":{"expired_at":"2026-12-31T23:59:59+08:00",...}}
    printf("%s\n", buf);
} else {
    char err[512];
    ZL_GetLastErrorMessage(h, err, sizeof(err));
    printf("失败(%d): %s\n", r, err);
}

#pragma comment(lib, "ZhilianSDK_x64.lib")

void* h = ZL_Create();
ZL_SetConfig(h, token);
if (ZL_CardLogin(h, card) == 0) {
    ZL_SetAutoHeartbeat(h, 1, 0);
    // 登录成功
}
ZL_Destroy(h);

import ctypes, os

# DLL 与脚本同目录；若放别处，把该目录加进搜索路径
os.add_dll_directory(os.path.dirname(os.path.abspath(__file__)))
dll = ctypes.WinDLL("ZhilianSDK_x64.dll")

dll.ZL_Create.restype = ctypes.c_void_p
dll.ZL_SetConfig.argtypes = [ctypes.c_void_p, ctypes.c_char_p]
dll.ZL_CardLogin.argtypes = [ctypes.c_void_p, ctypes.c_char_p]
dll.ZL_GetResult.argtypes = [ctypes.c_void_p, ctypes.c_char_p, ctypes.c_uint32]
dll.ZL_Destroy.argtypes = [ctypes.c_void_p]

h = dll.ZL_Create()
assert dll.ZL_SetConfig(h, open("token.txt").read().strip().encode()) == 0
assert dll.ZL_CardLogin(h, b"你的卡密") == 0

buf = ctypes.create_string_buffer(65536)
dll.ZL_GetExpire(h)
dll.ZL_GetResult(h, buf, 65536)
print(buf.value.decode("utf-8"))

dll.ZL_Destroy(h)

.局部变量 句柄, 整数型
.局部变量 结果, 文本型
.局部变量 长度, 整数型

句柄 ＝ ZL_Create ()
.如果真 (ZL_SetConfig (句柄, 配置串) ≠ 0)
    信息框 (“配置失败”, 0, , )
    返回 ()
.如果真结束

.如果真 (ZL_CardLogin (句柄, 卡密) ≠ 0)
    结果 ＝ 取空白文本 (512)
    ZL_GetLastErrorMessage (句柄, 结果, 512)
    信息框 (结果, 0, , )
    ZL_Destroy (句柄)
    返回 ()
.如果真结束

ZL_SetAutoHeartbeat (句柄, 1, 0)
' ... 业务代码 ...
ZL_Destroy (句柄)

using System;
using System.Runtime.InteropServices;
using System.Text;

class ZL {
    const string D = "ZhilianSDK_x64.dll";

    [DllImport(D, CallingConvention = CallingConvention.StdCall)]
    public static extern IntPtr ZL_Create();

    [DllImport(D, CallingConvention = CallingConvention.StdCall, CharSet = CharSet.Ansi)]
    public static extern int ZL_SetConfig(IntPtr h, string json);

    [DllImport(D, CallingConvention = CallingConvention.StdCall, CharSet = CharSet.Ansi)]
    public static extern int ZL_CardLogin(IntPtr h, string card);

    [DllImport(D, CallingConvention = CallingConvention.StdCall)]
    public static extern int ZL_SetAutoHeartbeat(IntPtr h, int enable, int interval);

    [DllImport(D, CallingConvention = CallingConvention.StdCall, CharSet = CharSet.Ansi)]
    public static extern int ZL_GetLastErrorMessage(IntPtr h, StringBuilder buf, uint size);

    [DllImport(D, CallingConvention = CallingConvention.StdCall)]
    public static extern void ZL_Destroy(IntPtr h);
}

// 调用
IntPtr h = ZL.ZL_Create();
if (ZL.ZL_SetConfig(h, token) != 0) { /* 失败 */ }
if (ZL.ZL_CardLogin(h, "卡密") == 0) {
    ZL.ZL_SetAutoHeartbeat(h, 1, 0);
}
ZL.ZL_Destroy(h);

function ZL_Create: Pointer; stdcall; external 'ZhilianSDK_x86.dll';
function ZL_SetConfig(h: Pointer; cfg: PAnsiChar): Integer; stdcall; external 'ZhilianSDK_x86.dll';
function ZL_CardLogin(h: Pointer; card: PAnsiChar): Integer; stdcall; external 'ZhilianSDK_x86.dll';

Private Declare Function ZL_Create Lib "ZhilianSDK_x86.dll" () As Long
Private Declare Function ZL_SetConfig Lib "ZhilianSDK_x86.dll" (ByVal h As Long, ByVal cfg As String) As Long
Private Declare Function ZL_CardLogin Lib "ZhilianSDK_x86.dll" (ByVal h As Long, ByVal card As String) As Long

# C
gcc main.c -I. -L. -lZhilianSDK -Wl,-rpath,'$ORIGIN' -o myapp

# C++
g++ main.cpp -I. -L. -lZhilianSDK -Wl,-rpath,'$ORIGIN' -o myapp

#include <stdio.h>
#include <stdlib.h>

int main(void) {
    void* h = ZL_Create();
    if (!h) { printf("创建失败\n"); return 1; }

    /* 粘贴后台「一键生成对接参数」里那串加密文本 */
    int r = ZL_SetConfig(h, "粘贴你的 product_token");
    if (r != 0) { printf("配置失败: %d\n", r); ZL_Destroy(h); return 1; }

    r = ZL_CardLogin(h, "你的卡密");
    if (r != 0) {
        char err[1024] = {0};
        ZL_GetLastErrorMessage(h, err, sizeof(err));
        printf("登录失败: %d %s\n", r, err);
        ZL_Destroy(h);
        return 1;
    }

    char* buf = (char*)malloc(65536);
    ZL_GetResult(h, buf, 65536);
    printf("登录结果: %s\n", buf);
    free(buf);

    ZL_SetAutoHeartbeat(h, 1, 0);   /* 自动心跳，周期跟随服务端下发 */
    /* ... 你的业务逻辑 ... */
    ZL_Destroy(h);
    return 0;
}

import ctypes

lib = ctypes.CDLL("./libZhilianSDK.so")
H, S, U = ctypes.c_void_p, ctypes.c_char_p, ctypes.c_uint32

lib.ZL_Create.restype        = H
lib.ZL_SetConfig.argtypes    = [H, S]
lib.ZL_CardLogin.argtypes    = [H, S]
lib.ZL_GetResult.argtypes    = [H, S, U]
lib.ZL_GetLastErrorMessage.argtypes = [H, S, U]
lib.ZL_SetAutoHeartbeat.argtypes    = [H, ctypes.c_int, ctypes.c_int]
lib.ZL_Destroy.argtypes      = [H]

h = lib.ZL_Create()
print("SetConfig =", lib.ZL_SetConfig(h, b"粘贴你的 product_token"))
print("CardLogin =", lib.ZL_CardLogin(h, b"你的卡密"))

buf = ctypes.create_string_buffer(65536)
lib.ZL_GetResult(h, buf, 65536)
print(buf.value.decode("utf-8", "replace"))

lib.ZL_SetAutoHeartbeat(h, 1, 0)
# ... 业务 ...
lib.ZL_Destroy(h)

chmod +x selftest

./selftest              # 不带卡：加载 / 机器码 / 配置 / 公告 / 更新 / 版本 / 挑战码
./selftest 你的卡密      # 完整：登录 / 心跳 / 到期 / 数据 / 授权 / 自动心跳

# 或者用 Python 版（信息更详细，会打印系统版本、glibc、.so 的 MD5）
python3 test_so.py 你的卡密

ZL_SetMachineRule(h, ZL_MACHINE_RULE_DEFAULT);   // 2
char mc[128];
ZL_GetMachineId(h, mc, sizeof(mc));
printf("机器码: %s\n", mc);   // 例如 EDB3C3254251E0206503850039E74BE6