{ "code": 200, // 状态码，200表示成功 "message": "成功", // 消息说明 "msg": "成功", // 消息说明（兼容字段） "data": { ... }, // 业务数据 "timestamp": 1705123456 // 服务器时间戳 }

{ "code": 200, "message": "成功", "data": { "public_key": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhki...\n-----END PUBLIC KEY-----", "server_time": 1705123456, "heartbeat_interval": 5 } }

{ "machine_code": "设备机器码（明码字符串）" } // 示例（Windows）: { "machine_code": "C5B1F6B2-5C7E-4AF2-9C1A-0F8B3A2D1E9A" }

{ "platform": "windows", // 平台: windows / android "os_version": "Windows 10", // 操作系统版本 "is_virtual": false, // 是否虚拟机 "virtual_type": "" // 虚拟机类型: vmware/virtualbox/hyper-v 等 }

{ "code": 200, "message": "激活成功", "data": { "token": "eyJhbGciOiJSUzI1NiJ9...", "refresh_token": "rf_abc123...", "expire_time": "2026-02-13 12:00:00", "remain_days": 30 } }

{ "code": 200, "data": { "status": "online", "server_time": 1705123456, "expire_time": "2026-02-13 12:00:00", "remain_seconds": 2592000, "cloud": { "vars": { "download_url": "https://example.com/download", "notice_text": "欢迎使用" }, "announcements": [ { "id": 1, "title": "系统维护通知", "content": "系统将于今晚22:00-24:00进行维护升级，期间可能影响正常使用，请提前保存工作。", "type": "notice", "is_popup": 1, "show_once": 1 }, { "id": 2, "title": "新版本发布", "content": "v2.1.0版本已发布，修复了若干已知问题，建议及时更新。", "type": "update", "is_popup": 0, "show_once": 1 } ], "latest_version": { "version": "2.0.0", "version_code": 200, "download_url": "https://...", "force_update": 0 }, "switches": { "feature_a": true, "maintenance": false } } } }

// 已读公告ID列表（建议持久化存储到本地文件或注册表） private static HashSet<int> _readAnnouncementIds = new HashSet<int>(); private static bool _isFirstHeartbeat = true; // 处理心跳响应中的公告数据 if (response.data.cloud?.announcements != null) { foreach (var announcement in response.data.cloud.announcements) { int id = announcement.id; int showOnce = announcement.show_once; // 1=只显示一次, 0=每次启动显示 int isPopup = announcement.is_popup; // 判断是否需要显示 bool shouldShow = false; if (showOnce == 1) { // 只显示一次模式：检查是否已读 if (!_readAnnouncementIds.Contains(id)) { shouldShow = true; } } else { // 每次启动显示模式：只在首次心跳时显示 if (_isFirstHeartbeat) { shouldShow = true; } } if (shouldShow) { string typeText = announcement.type switch { "notice" => "通知", "warning" => "警告", "update" => "更新", "ad" => "广告", _ => "公告" }; if (isPopup == 1) { // 弹窗显示 MessageBox.Show( announcement.content, $"[{typeText}] {announcement.title}", MessageBoxButtons.OK, announcement.type == "warning" ? MessageBoxIcon.Warning : MessageBoxIcon.Information ); } else { // 添加到公告列表 AddAnnouncementToList(id, announcement.title, announcement.content, announcement.type); } // 标记为已读（只对show_once=1的公告记录） if (showOnce == 1) { _readAnnouncementIds.Add(id); SaveReadIds(); // 持久化保存 } } } _isFirstHeartbeat = false; }

// 处理心跳响应中的公告数据 JSONArray announcements = cloudData.optJSONArray("announcements"); if (announcements != null) { for (int i = 0; i < announcements.length(); i++) { JSONObject announcement = announcements.getJSONObject(i); int id = announcement.getInt("id"); String title = announcement.getString("title"); String content = announcement.getString("content"); String type = announcement.getString("type"); int isPopup = announcement.getInt("is_popup"); // 如果需要弹窗显示 if (isPopup == 1) { // 在主线程显示弹窗 runOnUiThread(() -> { new AlertDialog.Builder(this) .setTitle(getTypeText(type) + " " + title) .setMessage(content) .setPositiveButton("确定", null) .show(); }); } else { // 添加到公告列表 addAnnouncementToList(id, title, content, type); } } } private String getTypeText(String type) { switch (type) { case "notice": return "📢 通知"; case "warning": return "⚠️ 警告"; case "update": return "🔄 更新"; case "ad": return "📺 广告"; default: return "📋 公告"; } }

{ "code": 200, "message": "刷新成功", "data": { "token": "eyJhbGciOiJSUzI1NiJ9...", "refresh_token": "rf_new123..." } }

{ "code": 200, "message": "试用激活成功", "data": { "token": "eyJhbGciOiJSUzI1NiJ9...", "refresh_token": "rf_trial...", "expire_time": "2026-01-13 12:30:00", "remain_seconds": 1800, "is_trial": true } }

1. 将业务参数按key字母顺序排序 2. 只拼接参数的值（不是key=value格式） 3. 拼接字符串: timestamp + nonce + 参数值 + client_secret 4. 计算SHA-256哈希得到sign 示例（激活接口）: 业务参数: app_key="SK_abc123", auth_code="AUTH001" 排序后: app_key, auth_code（按字母顺序） 拼接值: "SK_abc123" + "AUTH001" = "SK_abc123AUTH001" 最终字符串: "1705123456" + "randomnonce123" + "SK_abc123AUTH001" + "your_client_secret" sign = SHA256("1705123456randomnonce123SK_abc123AUTH001your_client_secret") 示例（心跳接口）: 业务参数: token="eyJhbGci..." 最终字符串: timestamp + nonce + token值 + client_secret sign = SHA256("1705123456randomnonce123eyJhbGci...your_client_secret")

{{ codes[tab] }}