• 按键公众号 ：
按键精灵电脑版
立即下载

软件版本：2014.06
软件大小：22.9M
更新时间：2021-12-03

按键精灵安卓版
立即下载

软件版本：4.2.4
软件大小：45M
更新时间：2025-12-22

按键精灵iOS版
立即下载

软件版本：2.4.7
软件大小：29.2M
更新时间：2026-1-28

按键手机助手
立即下载

软件版本：4.6.0
软件大小：242M
更新时间：2026-1-28

快捷导航

请 登录 后使用快捷导航
没有帐号？ 注册

登录 注册
返回列表
发新话题 回复该主题
查看: 287|回复: 5

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

兄弟客服03
头像

  • 管理员
  • 684365
  • 4956
  • 0
  • 1447 朵
  • 7957 个
  • 1466 个
  • 236380
  • 2011-06-13
按键X开拓者勋章按键15周年庆纪念勋章猴年勋章双十一绝版纪念勋章抗战胜利70周年勋章单身汪勋章体验先锋勋章按键14周年庆纪念勋章鹰眼勋章天使勋章潜水员按键明星黄金之翼按键精灵开发者2级龙年勋章十周年勋章兔年勋章论坛MM学有所成脚本作者管理人员
1#
t T
发表于 2026-04-29 10:51 | |只看楼主

本文档描述了安卓小精灵 HTTP 服务模块提供的所有 API 接口，包括脚本控制、系统信息获取等功能。方便开发者们调用后进行批量控制脚本启停、查看脚本运行状态、更改脚本配置等操作。


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

统一响应格式

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

  1. {
  2. "code": 200, // 状态码：200表示成功，其他表示错误
  3. "message": "success", // 响应消息
  4. "data": {} // 响应数据（可选）
  5. }
复制代码

响应状态码

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

基础接口
接口 方法 说明
/ 或 /health GET 健康检查，返回服务器运行状态

系统信息接口
GET
/api/v1/system/env

获取设备环境信息

响应示例
  1. {
  2. "code": 200,
  3. "message": "success",
  4. "data": {
  5. "hasRoot": true,
  6. "systemVersion": "Android 10",
  7. "sdkVersion": 29,
  8. "resolution": "1080x1920",
  9. "width": 1080,
  10. "height": 1920,
  11. "dpi": 480,
  12. "deviceModel": "Pixel 4",
  13. "brand": "Google"
  14. }
  15. }
复制代码
脚本控制接口
GET
/api/v1/script/info

获取脚本信息

响应示例
  1. {
  2. "code": 200,
  3. "message": "success",
  4. "data": {
  5. "id": "script_001",
  6. "name": "自动化脚本",
  7. "status": "running",
  8. "version": "1.0.0",
  9. "appVersion": "2.5.1"
  10. }
  11. }
复制代码
POST
/api/v1/script/execute

执行脚本

请求参数
  1. {
  2. "delayTime": 2, // 延迟执行时间（秒），可选
  3. "timeout": 60 // 超时时间（秒），可选
  4. }
复制代码
响应示例
  1. {
  2. "code": 200,
  3. "message": "Script executed successfully",
  4. "data": {
  5. "status": "completed",
  6. "startTime": "2026-04-17T10:30:00Z"
  7. }
  8. }
复制代码

POST
/api/v1/script/pause

暂停脚本

响应示例
  1. {
  2. "code": 200,
  3. "message": "脚本已暂停",
  4. "data": {
  5. "status": "paused",
  6. "pauseTime": "2026-04-17T10:35:00Z"
  7. }
  8. }
复制代码
POST
/api/v1/script/stop

停止脚本

响应示例
  1. {
  2. "code": 200,
  3. "message": "脚本已停止",
  4. "data": {
  5. "status": "stopped",
  6. "stopTime": "2026-04-17T10:40:00Z"
  7. }
  8. }
复制代码
POST
/api/v1/script/config

设置脚本配置

请求参数
  1. {
  2. "configKey1": "configValue1",
  3. "configKey2": "configValue2"
  4. }
复制代码
响应示例
  1. {
  2. "code": 200,
  3. "message": "配置更新成功",
  4. "data": {
  5. "updateTime": "2026-04-17T10:45:00Z"
  6. }
  7. }
复制代码


使用示例

通过 ADB 命令启动服务
  1. # 启动HTTP服务器（默认端口8080）
  2. adb shell am startservice -a HTTPD_ACTION_START_SERVER com.cyjh.elfin/.nanohttpd.service.HttpServerService

  4. # 指定端口启动HTTP服务器
  5. adb shell am startservice -a HTTPD_ACTION_START_SERVER --ei port 9000 com.cyjh.elfin/.nanohttpd.service.HttpServerService

  7. # 停止HTTP服务器
  8. adb shell am startservice -a HTTPD_ACTION_STOP_SERVER com.cyjh.elfin/.nanohttpd.service.HttpServerService

  10. # 端口转发
  11. adb forward tcp:8080 tcp:8080

  13. # 移除端口转发
  14. adb forward --remove tcp:8080

  16. # 移除所有端口转发
  17. adb forward --remove-all
复制代码

HTTP 请求示例
  1. # 健康检查
  2. curl http://localhost:8080/health

  4. # 获取系统环境信息
  5. curl http://localhost:8080/api/v1/system/env

  7. # 获取脚本信息
  8. curl http://localhost:8080/api/v1/script/info

  10. # 执行脚本（带延迟）
  11. curl -X POST http://localhost:8080/api/v1/script/execute \\
  12. -H "Content-Type: application/json" \\
  13. -d '{"delayTime": 2}'

  15. # 暂停脚本
  16. curl -X POST http://localhost:8080/api/v1/script/pause

  18. # 停止脚本
  19. curl -X POST http://localhost:8080/api/v1/script/stop

  21. # 设置脚本配置
  22. curl -X POST http://localhost:8080/api/v1/script/config \\
  23. -H "Content-Type: application/json" \\
  24. -d '{"speed": "fast", "loopCount": 10}'
复制代码

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

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

    脚本定制QQ:262832680

    • 官方脚本作者
    • 2991681
    • 5667
    • 0
    • 1913 朵
    • 20451 个
    • 2324 个
    • 192100
    • 2015-01-06
    图灵勋章天使勋章按键明星骨灰级按键用户按键精灵开发者6级论坛GG小红帽学有所成
    2#
    t T
    发表于 2026-04-29 13:42 | |只看该用户

    按键精灵太强了,按键精灵天下第一

    承接各类游戏脚本制作,post,手游,端游,办公,自动化

    有偿解决任何按键基础问题（可远程讲解、教会为止）
    如果我的回答能帮助了你,大家可以加个好友互相了解
    QQ : 262832680
    回顶部
    jianqiao87
    头像

    jianqiao87

    • 初中一年级
    • 653803
    • 210
    • 0
    • 5 朵
    • 293 个
    • 9 个
    • 9480
    • 2011-05-06
    3#
    t T
    发表于 2026-04-29 13:58 | |只看该用户

    这个是什么用的

    回顶部
    紫猫
    头像

    [紫猫学院创始人]

    • 版主
    • 513852
    • 3629
    • 47
    • 4638 朵
    • 28057 个
    • 6162 个
    • 190000
    • 2010-10-09
    按键X开拓者勋章过大年勋章双十一绝版纪念勋章单身汪勋章幸运草勋章鹰眼勋章黄瓜勋章图灵勋章活动狂人骨灰级按键用户按键精灵开发者6级小编勋章龙年勋章QUI设计大师十周年勋章教程达人兔年勋章论坛GG小红帽学有所成
    4#
    t T
    发表于 2026-04-29 16:50 | |只看该用户

    这个接口直接开放了?那就可以自己写一个控制台了


    【紫猫编程学园】火热招生中

    教学涉及按键精灵电脑版、按键精灵手机版、Lua编程。

    包含网页、端游、手游、办公、模拟器、插件等。

    报名咨询QQ:345911220 或 97682686 或 97682687;

    报名咨询微信:zimaoxy; 点我在线交谈

    紫猫学园免费教程

    加入交流QQ群: 7333555
    回顶部
    zjcyjj
    头像

    zjcyjj

    • 大学三年级
    • 3328028
    • 1498
    • 0
    • 200 朵
    • 3958 个
    • 205 个
    • 26840
    • 2015-06-28
    小红帽
    5#
    t T
    发表于 2026-04-29 18:19 | |只看该用户

    对应安卓小精灵版本号 6.7.5 及以上 是什么意思

    回顶部
    江书翔
    头像

    江书翔

    • 官方脚本作者
    • 4642320
    • 4109
    • 0
    • 2566 朵
    • 4206 个
    • 2818 个
    • 520
    • 2017-09-23
    黄金之翼按键精灵开发者5级
    6#
    t T
    发表于 2026-04-29 18:21 | |只看该用户

    按键精灵牛逼

    全职脚本作者 受人之托，忠人之事。 接脚本制作 : QQ 1163300722
    回顶部
    上一主题| 下一主题
    返回列表
    发新话题 回复该主题
    高级编辑器高级编辑器