多语言对接 SDK

覆盖 8 种主流开发语言,开箱即用。统一支持卡密验证、公告获取、版本更新、强制更新、心跳保活等全部能力。

接入建议:先使用「明文模式」(mi_type=0)调通流程,确认无误后再到后台开启加密与签名,可大幅降低调试成本。

选择你的开发语言

PHP
适用于 Web 后端、ThinkPHP / Laravel / 原生 PHP 项目
Python
适用于脚本、爬虫、桌面工具、自动化项目(Python 3.7+)
JavaScript / Node.js
适用于 Node.js 服务端、Electron、现代浏览器
Java
适用于 Android / 桌面 Java 应用(JDK 8+)
C# / .NET
适用于 Windows 桌面、Unity、.NET 项目
Go
适用于 Go 服务端与命令行工具(Go 1.16+)
Lua
适用于 GameGuardian / 触动精灵 / 标准 Lua
易语言
适用于易语言桌面应用(需精易模块)

功能对照表

功能 方法名 说明
卡密登录login校验卡密与设备码,返回到期时间
心跳保活heartbeat定时调用标记在线,建议 30~60 秒一次
退出心跳heartbeatQuit客户端正常退出时调用,立即标记离线
获取公告notice拉取应用公告文本内容
应用配置config版本号、更新地址、加密参数等
检查更新checkUpdate判断是否有新版本、是否强制更新
卡密解绑unbind清除卡密与设备的绑定关系
外链文件getFiles获取应用下配置的外链文件列表
账号登录userLogin应用内账号体系(区别于卡密登录)
账号注册userRegister注册应用内账号
账号心跳userHeartbeat账号体系的心跳保活

通用配置参数

参数 类型 说明
base_urlstring验证服务器地址,如 https://skyayue.top
app_idint应用 ID,在后台应用列表中查看
app_keystring应用密钥,用于请求签名
rc4_keystring通信密钥,用于 RC4 / AES 加解密
mi_typeint加密类型:0=明文 1=RC4 2=Base64
signbool是否启用签名校验
timeoutint请求超时(毫秒),默认 10000
设备码(markcode)说明:这是客户端的唯一标识,用于卡密绑定设备、设备封禁、在线统计。 首次运行生成后必须持久化保存到本地(配置文件 / 注册表 / SharedPreferences),之后一直沿用。 各语言 SDK 均提供了 generateMarkcode() 辅助函数用于生成。
完整接入说明、示例代码、返回码对照请参阅 SDK 使用文档