API 接入文档

{ "success": true, // 是否成功 (boolean) "error": "错误信息", // 仅失败时存在 (string) "...": "其他业务数据" // 成功时的业务数据 }

{ "success": true, "apps": [ { "id": "hello_world", "name": "Hello World", "description": "第一个小程序", "version": 1, "icon_url": "cips/hello_world/assets/icon.png", "enabled": true, "uploaded_at": "2026-07-29 12:00:00" } ] }

var xhr = new XMLHttpRequest(); xhr.open('GET', 'https://app.524090.xyz/api.php?action=list'); xhr.onload = function() { var res = JSON.parse(xhr.responseText); if (res.success) { console.log(res.apps); // 小程序数组 } }; xhr.send();

URL url = new URL("https://app.524090.xyz/api.php?action=list"); HttpURLConnection conn = (HttpURLConnection) url.openConnection(); conn.setRequestMethod("GET"); conn.setRequestProperty("Accept", "application/json"); InputStream is = conn.getInputStream(); // 使用 JSON 库解析响应 BufferedReader reader = new BufferedReader( new InputStreamReader(is)); StringBuilder sb = new StringBuilder(); String line; while ((line = reader.readLine()) != null) { sb.append(line); } System.out.println(sb.toString());

{ "success": true, "manifest": { "id": "hello_world", "name": "Hello World", "description": "第一个小程序", "version": 1, "icon_url": "assets/icon.png", "enabled": true, "order": 0, "permissions": ["network"], "allowed_hosts": ["example.com"] }, "lua": "-- main.lua source code", "assets": { "assets/icon.png": "cips/hello_world/assets/icon.png", "assets/screenshot.png": "cips/hello_world/assets/screenshot.png" } }

{ "success": true, "message": "小程序 Hello World 上传成功", "id": "hello_world" }

{ "success": false, "error": "压缩包中未找到 manifest.json" }

var formData = new FormData(); formData.append('file', fileInput.files[0]); var xhr = new XMLHttpRequest(); xhr.open('POST', 'https://app.524090.xyz/api.php?action=upload'); xhr.upload.onprogress = function(e) { if (e.lengthComputable) { var pct = Math.round(e.loaded / e.total * 100); console.log('上传进度: ' + pct + '%'); } }; xhr.onload = function() { var res = JSON.parse(xhr.responseText); if (res.success) { console.log('上传成功, ID: ' + res.id); } else { console.log('上传失败: ' + res.error); } }; xhr.send(formData);

// 使用 OkHttp 库 File file = new File("/sdcard/app.cip"); RequestBody body = new MultipartBody.Builder() .setType(MultipartBody.FORM) .addFormDataPart("file", file.getName(), RequestBody.create(file, MediaType.parse("application/zip"))) .build(); Request request = new Request.Builder() .url("https://app.524090.xyz/api.php?action=upload") .post(body) .build(); Response response = client.newCall(request).execute(); String json = response.body().string(); // 解析 JSON 获取结果

Content-Type: application/zip Content-Disposition: attachment; filename="hello_world.cip" Content-Length: 102400

{"success": false, "error": "小程序不存在"}

URL url = new URL("https://app.524090.xyz/api.php?action=download&id=hello_world"); HttpURLConnection conn = (HttpURLConnection) url.openConnection(); conn.setRequestMethod("GET"); if (conn.getResponseCode() == 200) { InputStream is = conn.getInputStream(); File outputFile = new File("/sdcard/download/hello_world.cip"); FileOutputStream fos = new FileOutputStream(outputFile); byte[] buffer = new byte[4096]; int len; while ((len = is.read(buffer)) != -1) { fos.write(buffer, 0, len); } fos.close(); is.close(); System.out.println("下载完成: " + outputFile.getAbsolutePath()); } else { // 读取错误 JSON InputStream es = conn.getErrorStream(); // 解析错误信息 }

{ "id": "hello_world", // 必填, 唯一标识, [a-z0-9_-]{1,64} "name": "Hello World", // 必填, 应用名称, 最多40字 "description": "一个示例小程序", // 选填, 描述, 最多200字 "version": 1, // 选填, 版本号, 默认1 "icon_url": "assets/icon.png", // 选填, 图标路径(包内)或完整URL "enabled": true, // 选填, 是否启用, 默认true "order": 0, // 选填, 排序值, 越小越靠前 "permissions": [ // 选填, 权限列表 "network", "storage" ], "allowed_hosts": [ // 选填, 允许访问的主机 "api.example.com" ] }

my_app.cip (或 .zip) ├── manifest.json // 必填, 应用元数据 ├── main.lua // 选填, 小程序界面逻辑 └── assets/ // 选填, 资源目录 ├── icon.png // 图标 ├── screenshot.png // 截图 └── ...

-- main.lua 示例 title = "我的小程序" ui.text { text = "欢迎来到旧聊!", size = 18, color = "#A4C639", center = true } ui.button { id = "btn_ok", text = "确定" } ui.image { id = "img_logo", url = "assets/icon.png", height = 64 } ui.input { id = "input_name", hint = "请输入名称", single_line = true, max_length = 20 }