跳转到内容

企业版开放接口

说明

企业版开放接口给第三方语言使用:即使不会 EC 的 JS,也可用 Python、易语言、C++ 等通过 HTTP 对接中控,编写自动化。

  • 请求方式:HTTP(多数为 POSTContent-Type: application/json
  • URL 前缀:中控地址,例如 http://127.0.0.1:8019,后面跟上接口路径
  • 通用返回:code0 表示成功,其它为失败,msg 为错误信息
  • 文档按模块拆分(来源:Apifox 导出 + USB HID 补充),请从下表进入

请求示例

BASE 换成你的中控地址。下面先查设备列表,再演示 USB HID:开会话 → 设分辨率 → 点击。

deviceId设备列表 接口返回值里取。

import requests
BASE = "http://127.0.0.1:8019"
def openapi_post(path, body=None):
r = requests.post(f"{BASE}{path}", json=body or {}, timeout=30)
r.raise_for_status()
data = r.json()
if data.get("code") != 0:
raise RuntimeError(data.get("msg") or data)
return data
# 1) 设备列表
print(openapi_post("/openapi/deviceList", {"deviceId": "", "groupId": ""}))
# 2) USB HID:开会话 → 设分辨率 → 点击
DEVICE_ID = "90e2f3834c0977205e441aa664916a9bdde81e8d"
openapi_post("/openapi/usbhidSessionStart", {"deviceId": DEVICE_ID, "gate": True})
openapi_post("/openapi/usbhidSetScreenSize", {"deviceId": DEVICE_ID, "w": 1170, "h": 2532})
openapi_post("/openapi/usbhidClickPoint", {"deviceId": DEVICE_ID, "x": 200, "y": 400})

依赖:pip install requests

其它接口同样是 POST + JSON body,把路径和参数换成各模块页中的说明即可。

模块目录

模块说明
自动化 · 截图截图、图片流
自动化 · 动作点击、滑动、输入、App
自动化 · 启停自动化启动/释放自动化、隧道、电量
自动化 · 相册上传图片/视频、清空相册
自动化 · 文件操作设备文件推送与拉取
自动化 · IME 输入法自定义输入法、剪贴板转发
自动化 · 蓝牙 BLE蓝牙板 HID 动作
自动化 · USB HID免硬件数据线控制手机
中控接口设备列表、脚本启停等
辅助助手助手剪贴板、相册、端口转发
快捷指令助手需配合快捷指令助手程序,路径见该页正文

接口分类说明

  • 中控接口:设备列表、执行/停止脚本等,HTTP 调用
  • 自动化接口:截图、点击、滑动、输入、相册、IME、蓝牙 BLE、USB HID 等
  • USB HID
    • 无需蓝牙/OTG 开发板,经 USB 数据线模拟点击与输入
    • 投屏场景见 新界面操作指引

历史 Apifox(备份)

在线链接(不含完整 USB HID,以站内文档为准):