安卓小精灵HTTP服务模块API接口说明 _ 按键精灵手机版

查看: 3414\|回复: 9	[源码分享] 安卓小精灵HTTP服务模块API接口说明 [复制链接]

兄弟客服03

组别管理员
UID684365
帖子4979
精华0
鲜花1482 朵
铜币8034 个
银币1513 个
在线时间236380
注册时间2011-06-13

1^#

字体大小: t T

发表于 2026-04-29 10:51 | |只看楼主

本文档描述了安卓小精灵 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}'

复制代码

已有1评分我要评分查看所有评分

本主题由超级版主瑞祥幽冥狼于 2026/8/15 8:19:20 执行审核帖子操作

按键精灵iOS版，开发iOS脚本，可打包iOS脚本小精灵，还支持分享收费型脚本。iOS15和iOS16系统已兼容！——点我查看详情

鹰眼中控，手机群控软件，苹果群控软件，已兼容iOS15、iOS16系统，手机屏幕实时显示，支持远程操作！——点我查看详情

回顶部

发送短消息 UID 2991681 帖子 5757 精华 0 鲜花 2003 朵铜币 20541 个银币 2414 个性别在线时间 192100 注册时间 2015-01-06 最后登录 2026-08-15 262832680 查看公共资料搜索主题搜索帖子 jy262832680 脚本定制QQ:262832680 组别官方脚本作者 UID2991681 帖子5757 精华0 鲜花2003 朵铜币20541 个银币2414 个在线时间192100 注册时间2015-01-06 图灵勋章参与按键精灵验证码识别大赛奖励天使勋章天使一样的用户按键明星按键明星勋章骨灰级按键用户 3年以上的按键论坛用户按键精灵开发者6级可通过提升认证等级来升级勋章：rz.anjian.com 论坛GG 按键论坛男性用户勋章小红帽对论坛提出良好建议（可向管理员申请）学有所成学有所成勋章，新手步入按键学堂的第一枚勋章	2^# 字体大小: t T 发表于 2026-04-29 13:42 \| \|只看该用户按键精灵太强了,按键精灵天下第一
	承接各类游戏脚本制作,post,手游,端游,办公,自动化有偿解决任何按键基础问题（可远程讲解、教会为止）如果我的回答能帮助了你,大家可以加个好友互相了解 QQ : 262832680

	回顶部

发送短消息 UID 653803 帖子 210 精华 0 鲜花 5 朵铜币 293 个银币 9 个性别在线时间 9480 注册时间 2011-05-06 最后登录 2026-04-30 71149355 查看公共资料搜索主题搜索帖子 jianqiao87 jianqiao87 组别初中一年级 UID653803 帖子210 精华0 鲜花5 朵铜币293 个银币9 个在线时间9480 注册时间2011-05-06	3^# 字体大小: t T 发表于 2026-04-29 13:58 \| \|只看该用户这个是什么用的


	回顶部

发送短消息 UID 513852 帖子 3629 精华 47 鲜花 4658 朵铜币 28057 个银币 6162 个性别在线时间 190000 注册时间 2010-10-09 最后登录 2026-08-06 345911220 查看公共资料搜索主题搜索帖子紫猫 [紫猫学院创始人] 组别版主 UID513852 帖子3629 精华47 鲜花4658 朵铜币28057 个银币6162 个在线时间190000 注册时间2010-10-09 按键X开拓者勋章按键精灵X版开拓者勋章过大年勋章俩小福娃给大家拜年啦！双十一绝版纪念勋章双十一绝版纪念勋章单身汪勋章单身贵族的专属勋章幸运草勋章商业小精灵限时活动勋章。鹰眼勋章鹰眼注册用户专属勋章黄瓜勋章体验商业小精灵活动的奖励图灵勋章参与按键精灵验证码识别大赛奖励活动狂人论坛活动狂人骨灰级按键用户 3年以上的按键论坛用户按键精灵开发者6级可通过提升认证等级来升级勋章：rz.anjian.com 小编勋章感谢你为按键精灵教科书做出的贡献龙年勋章龙年纪念勋章 QUI设计大师 QUI设计大师十周年勋章十周年纪念勋章教程达人教程达人兔年勋章兔年纪念勋章论坛GG 按键论坛男性用户勋章小红帽对论坛提出良好建议（可向管理员申请）学有所成学有所成勋章，新手步入按键学堂的第一枚勋章	4^# 字体大小: t T 发表于 2026-04-29 16:50 \| \|只看该用户这个接口直接开放了?那就可以自己写一个控制台了已有1评分我要评分查看所有评分
	【紫猫编程学园】火热招生中教学涉及按键精灵电脑版、按键精灵手机版、Lua编程。包含网页、端游、手游、办公、模拟器、插件等。报名咨询QQ:345911220 或 97682686 或 97682687; 报名咨询微信:zimaoxy; 点我在线交谈紫猫学园免费教程加入交流QQ群: 7333555

	回顶部

发送短消息 UID 3328028 帖子 1498 精华 0 鲜花 200 朵铜币 3958 个银币 205 个性别在线时间 26840 注册时间 2015-06-28 最后登录 2026-07-16 查看公共资料搜索主题搜索帖子 zjcyjj zjcyjj 组别大学三年级 UID3328028 帖子1498 精华0 鲜花200 朵铜币3958 个银币205 个在线时间26840 注册时间2015-06-28 小红帽对论坛提出良好建议（可向管理员申请）	5^# 字体大小: t T 发表于 2026-04-29 18:19 \| \|只看该用户对应安卓小精灵版本号 6.7.5 及以上是什么意思


	回顶部

发送短消息 UID 4642320 帖子 4140 精华 0 鲜花 2597 朵铜币 4237 个银币 2849 个性别在线时间 520 注册时间 2017-09-23 最后登录 2026-08-15 1163300722 查看公共资料搜索主题搜索帖子江书翔江书翔组别官方脚本作者 UID4642320 帖子4140 精华0 鲜花2597 朵铜币4237 个银币2849 个在线时间520 注册时间2017-09-23 黄金之翼黄金之翼勋章按键精灵开发者5级可通过提升认证等级来升级勋章：rz.anjian.com	6^# 字体大小: t T 发表于 2026-04-29 18:21 \| \|只看该用户按键精灵牛逼
	全职脚本作者受人之托，忠人之事。接脚本制作 : QQ 1163300722

	回顶部

发送短消息 UID 8843741 帖子 5 精华 0 鲜花 6 朵铜币 6 个银币 6 个性别在线时间 0 注册时间 2022-09-09 最后登录 2026-05-31 1263417675 查看公共资料搜索主题搜索帖子 chenshi5 陈氏组别幼儿园 UID8843741 帖子5 精华0 鲜花6 朵铜币6 个银币6 个在线时间0 注册时间2022-09-09	7^# 字体大小: t T 发表于 2026-05-04 03:16 \| \|只看该用户按键精灵牛逼


	回顶部

发送短消息 UID 8843741 帖子 5 精华 0 鲜花 6 朵铜币 6 个银币 6 个性别在线时间 0 注册时间 2022-09-09 最后登录 2026-05-31 1263417675 查看公共资料搜索主题搜索帖子 chenshi5 陈氏组别幼儿园 UID8843741 帖子5 精华0 鲜花6 朵铜币6 个银币6 个在线时间0 注册时间2022-09-09	8^# 字体大小: t T 发表于 2026-05-04 03:17 \| \|只看该用户按键精灵牛逼.


	回顶部

发送短消息 UID 8870628 帖子 20 精华 0 鲜花 88 朵铜币 66 个银币 41 个性别在线时间 0 注册时间 2022-10-14 最后登录 2026-07-29 906326906 查看公共资料搜索主题搜索帖子 13428791342 13428791342 组别小学一年级 UID8870628 帖子20 精华0 鲜花88 朵铜币66 个银币41 个在线时间0 注册时间2022-10-14	9^# 字体大小: t T 发表于 2026-06-02 00:57 \| \|只看该用户能不能用脚本本身启动http服务？


	回顶部

发送短消息 UID 8842065 帖子 3 精华 0 鲜花 2 朵铜币 4 个银币 4 个性别在线时间 0 注册时间 2022-09-07 最后登录 2026-08-15 799850605 查看公共资料搜索主题搜索帖子 Mrzhu662 Mrzhu662 组别幼儿园 UID8842065 帖子3 精华0 鲜花2 朵铜币4 个银币4 个在线时间0 注册时间2022-09-07	10^# 字体大小: t T 发表于 2026-08-15 06:58 \| \|只看该用户 Import "shanhai.lua" // //# ======================================================== //# \226\156\133 唯一正确命令（你的小米6X设备，免Root小精灵） //# ======================================================== //adb -s 192.168.30.22:5555 shell am startservice ^ //-n com.dd/com.cyjh.elfin.nanohttpd.service.HttpServerService ^ //-a HTTPD_ACTION_START_SERVER // //# 指定端口9000版本： //adb -s 192.168.30.22:5555 shell am startservice ^ //-n com.dd/com.cyjh.elfin.nanohttpd.service.HttpServerService ^ //-a HTTPD_ACTION_START_SERVER --ei port 9000 // //# 停止服务： //adb -s 192.168.30.22:5555 shell am startservice ^ //-n com.dd/com.cyjh.elfin.nanohttpd.service.HttpServerService ^ //-a HTTPD_ACTION_STOP_SERVER // // // // // // 脚本内部直接启动HTTP服务（不需要电脑端ADB） Dim 启动结果启动结果 = ShanHai.execute("am startservice -n com.dd/com.cyjh.elfin.nanohttpd.service.HttpServerService -a HTTPD_ACTION_START_SERVER") TracePrint "HTTP服务启动返回：" & 启动结果 Delay 3000 ' 等3秒初始化 // 脚本内验证是否成功（本机回环地址） Dim 健康检查健康检查 = ShanHai.execute("wget -q -O - --timeout=2 http://127.0.0.1:8080/health") TracePrint "本地健康检查：" & 健康检查 If InStr(1, 健康检查, "200") > 0 Then ShowMessage "HTTP服务启动成功" Else ShowMessage "HTTP服务启动失败" End If


	回顶部

上一主题| 下一主题

发送短消息 UID 513852 帖子 3629 精华 47 鲜花 4658 朵铜币 28057 个银币 6162 个性别在线时间 190000 注册时间 2010-10-09 最后登录 2026-08-06 345911220 查看公共资料搜索主题搜索帖子紫猫 [紫猫学院创始人] 组别版主 UID513852 帖子3629 精华47 鲜花4658 朵铜币28057 个银币6162 个在线时间190000 注册时间2010-10-09 按键X开拓者勋章按键精灵X版开拓者勋章过大年勋章俩小福娃给大家拜年啦！双十一绝版纪念勋章双十一绝版纪念勋章单身汪勋章单身贵族的专属勋章幸运草勋章商业小精灵限时活动勋章。鹰眼勋章鹰眼注册用户专属勋章黄瓜勋章体验商业小精灵活动的奖励图灵勋章参与按键精灵验证码识别大赛奖励活动狂人论坛活动狂人骨灰级按键用户 3年以上的按键论坛用户按键精灵开发者6级可通过提升认证等级来升级勋章：rz.anjian.com 小编勋章感谢你为按键精灵教科书做出的贡献龙年勋章龙年纪念勋章 QUI设计大师 QUI设计大师十周年勋章十周年纪念勋章教程达人教程达人兔年勋章兔年纪念勋章论坛GG 按键论坛男性用户勋章小红帽对论坛提出良好建议（可向管理员申请）学有所成学有所成勋章，新手步入按键学堂的第一枚勋章	4^# 字体大小: t T 发表于 2026-04-29 16:50 \| \|只看该用户这个接口直接开放了?那就可以自己写一个控制台了已有1评分我要评分查看所有评分
	【紫猫编程学园】火热招生中教学涉及按键精灵电脑版、按键精灵手机版、Lua编程。包含网页、端游、手游、办公、模拟器、插件等。报名咨询QQ:345911220 或 97682686 或 97682687; 报名咨询微信:zimaoxy; 点我在线交谈紫猫学园免费教程加入交流QQ群: 7333555

	回顶部

[源码分享] 安卓小精灵HTTP服务模块API接口说明 [复制链接]