当前位置：首页>安卓APP>[更新公告]安卓小精灵HTTP服务模块API接口说明

[更新公告]安卓小精灵HTTP服务模块API接口说明

2026-07-19 14:43:00

本文档描述了安卓小精灵 HTTP 服务模块提供的所有 API 接口，包括脚本控制、系统信息获取等功能。

注意：对应安卓小精灵版本号 6.7.5 及以上，可使用按键精灵手机助手 4.6.0 及以上版本打包。统一响应格式

所有 API 响应均采用统一的 JSON 格式：

{"code": 200, // 状态码：200表示成功，其他表示错误"message": "success", // 响应消息"data": {} // 响应数据（可选）}

响应状态码

code	message	说明
200	success	请求成功
400	请求参数错误	参数缺失或无效
404	未找到对应的API接口	API不存在
408	执行超时	请求处理超时
500	错误信息	服务器内部错误

基础接口
接口方法说明
/ 或 /health GET 健康检查，返回服务器运行状态
系统信息接口GET/api/v1/system/env获取设备环境信息

响应示例

{"code": 200,"message": "success","data": {"hasRoot": true,"systemVersion": "Android 10","sdkVersion": 29,"resolution": "1080x1920","width": 1080,"height": 1920,"dpi": 480,"deviceModel": "Pixel 4","brand": "Google"}}

脚本控制接口GET/api/v1/script/info获取脚本信息响应示例

{"code": 200,"message": "success","data": {"id": "script_001","name": "自动化脚本","status": "running","version": "1.0.0","appVersion": "2.5.1"}}

POST/api/v1/script/execute执行脚本请求参数

{"delayTime": 2, // 延迟执行时间（秒），可选"timeout": 60 // 超时时间（秒），可选}

响应示例

{"code": 200,"message": "Script executed successfully","data": {"status": "completed","startTime": "2026-04-17T10:30:00Z"}}

POST/api/v1/script/pause暂停脚本响应示例

{"code": 200,"message": "脚本已暂停","data": {"status": "paused","pauseTime": "2026-04-17T10:35:00Z"}}

POST/api/v1/script/stop停止脚本响应示例

{"code": 200,"message": "脚本已停止","data": {"status": "stopped","stopTime": "2026-04-17T10:40:00Z"}}

POST/api/v1/script/config设置脚本配置请求参数

{"configKey1": "configValue1","configKey2": "configValue2"}

响应示例

{"code": 200,"message": "配置更新成功","data": {"updateTime": "2026-04-17T10:45:00Z"}}

使用示例通过 ADB 命令启动服务

# 启动HTTP服务器（默认端口8080）adb shell am startservice -a HTTPD_ACTION_START_SERVER com.cyjh.elfin/.nanohttpd.service.HttpServerService# 指定端口启动HTTP服务器adb shell am startservice -a HTTPD_ACTION_START_SERVER --ei port 9000 com.cyjh.elfin/.nanohttpd.service.HttpServerService# 停止HTTP服务器adb shell am startservice -a HTTPD_ACTION_STOP_SERVER com.cyjh.elfin/.nanohttpd.service.HttpServerService# 端口转发adb forward tcp:8080 tcp:8080# 移除端口转发adb forward --remove tcp:8080# 移除所有端口转发adb forward --remove-all

HTTP 请求示例

# 健康检查curl http://localhost:8080/health# 获取系统环境信息curl http://localhost:8080/api/v1/system/env# 获取脚本信息curl http://localhost:8080/api/v1/script/info# 执行脚本（带延迟）curl -X POST http://localhost:8080/api/v1/script/execute \\-H "Content-Type: application/json" \\-d '{"delayTime": 2}'# 暂停脚本curl -X POST http://localhost:8080/api/v1/script/pause# 停止脚本curl -X POST http://localhost:8080/api/v1/script/stop# 设置脚本配置curl -X POST http://localhost:8080/api/v1/script/config \\-H "Content-Type: application/json" \\-d '{"speed": "fast", "loopCount": 10}'