# 开放 API

MoreLogin 开放 API 提供了一个全面且对开发者友好的 RESTful 接口，使您能够以编程方式管理浏览器、云手机及相关资源，从而实现无缝自动化、可扩展性和控制。MoreLogin 开放 API 运行在您的计算机上，可通过以下网址访问：https://api.morelogin.com

Version: 1.0.0

## Security

### Authorization

[object Object]

Type: http
In: header
Name: Authorization
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

 - [开放 API](https://guide.morelogin.com/_bundle/@l10n/zh/API%20Reference/Cloud%20Phone/open-api.yaml)

## Authorization

 - [POST /oauth2/token](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/authorization/paths/~1oauth2~1token/post.md)
 - [GET /oauth2/userinfo](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/authorization/paths/~1oauth2~1userinfo/get.md)
## Cloud Phone Management

 - [POST /cloudphone/page](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/cloud-phone-management/pageusingpost.md)
 - [POST /cloudphone/create](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/cloud-phone-management/createusingpost.md)
 - [POST /cloudphone/powerOn](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/cloud-phone-management/poweronusingpost.md)
 - [POST /cloudphone/powerOff](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/cloud-phone-management/poweroffusingpost.md)
 - [POST /cloudphone/edit/batch](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/cloud-phone-management/editbatchusingpost.md)
 - [POST /cloudphone/setProxy](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/cloud-phone-management/setproxy.md): 设置一个或多个云手机的代理设置。支持直接绑定 proxyId，或添加/修改详细的代理参数。请求体格式与浏览器代理配置相同，设置会立即生效。
 - [POST /cloudphone/delete/batch](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/cloud-phone-management/deleteusingpost.md)
 - [POST /cloudphone/newMachine](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/cloud-phone-management/onenewusingpost.md)
 - [POST /cloudphone/info](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/cloud-phone-management/infousingpost.md)
 - [POST /cloudphone/queryByAndroidId](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/cloud-phone-management/querybyandroidid.md): 查询当前团队下与特定 androidId 关联 of 云手机 ID。如果找到，返回单个云手机 ID。
 - [POST /cloudphone/enableRoot](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/cloud-phone-management/enableroot.md): 启用或禁用单个云手机上的全局系统级 ROOT 权限。
 - [POST /cloudphone/screenCap](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/cloud-phone-management/screencap.md): 获取指定云手机实例的实时屏幕截图。支持返回带有过期时间戳的临时签名 URL。
 - [POST /cloudphone/screenCapBase64](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/cloud-phone-management/screencapbase64.md): 获取指定云手机实例的实时截屏。目前仅支持 Android 12 和 Android 15。
 - [POST /cloudphone/brand/models](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/cloud-phone-management/paths/~1cloudphone~1brand~1models/post.md): 查询给定安卓版本的可用品牌和型号列表
## ADB

 - [POST /cloudphone/updateAdb](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/adb/updateadbusingpost.md)
 - [POST /cloudphone/batchAdbInfo](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/adb/batchadbinfo.md): 批量查询云手机 ADB 连接信息。 - envIds 列表最多支持 200 个项目。 - 支持跨 wuin 和 arm 提供商的混合查询；API 内部按提供商分组并合并结果。 - ADB 信息仅在手机开机时可用（envStatus >= 4）；关机或启动时无法查询。
 - [POST /cloudphone/exeCommand](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/adb/executeshellcommand.md)
## Files

 - [POST /cloudphone/uploadUrl](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/files/get.md): 通过此界面上传临时文件，系统将在7天后自动删除它们。
 - [POST /cloudphone/uploadFile](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/files/fileuploadusing.md)
 - [POST /cloudphone/uploadFileResult](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/files/fileuploadresult.md)
 - [POST /cloudphone/download](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/files/paths/~1cloudphone~1download/post.md)
 - [POST /cloudphone/download/result](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/files/paths/~1cloudphone~1download~1result/post.md)
 - [POST /cloudphone/setKeyBox](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/files/paths/~1cloudphone~1setkeybox/post.md)
## Apps

 - [POST /cloudphone/app/install](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/apps/paths/~1cloudphone~1app~1install/post.md)
 - [POST /cloudphone/app/page](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/apps/paths/~1cloudphone~1app~1page/post.md): 获取 APP 应用列表
 - [POST /cloudphone/team/app/page](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/apps/paths/~1cloudphone~1team~1app~1page/post.md): 获取团队下的应用列表。
 - [POST /cloudphone/app/installedList](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/apps/paths/~1cloudphone~1app~1installedlist/post.md): 查询云手机上已安装的应用列表
 - [POST /cloudphone/app/start](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/apps/paths/~1cloudphone~1app~1start/post.md): 在云手机上启动已安装的应用
 - [POST /cloudphone/app/restart](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/apps/paths/~1cloudphone~1app~1restart/post.md)
 - [POST /cloudphone/app/stop](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/apps/paths/~1cloudphone~1app~1stop/post.md)
 - [POST /cloudphone/app/uninstall](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/apps/paths/~1cloudphone~1app~1uninstall/post.md)
 - [POST /cloudphone/app/openRoot](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/apps/appopenroot.md): 启用单个云手机上特定应用包的 ROOT 权限。
 - [POST /cloudphone/app/setHideAccessibilityApp](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/apps/paths/~1cloudphone~1app~1sethideaccessibilityapp/post.md): 仅支持 Android 13、Android 14 和 Android 15A。
## Schedules

 - [POST /cloudphone/rpa/template/market/page](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/schedules/paths/~1cloudphone~1rpa~1template~1market~1page/post.md): 查询时间表市场模板，模板名称支持模糊查询
 - [POST /cloudphone/rpa/template/personal/page](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/schedules/paths/~1cloudphone~1rpa~1template~1personal~1page/post.md): 查询时间表市场模板，模板名称支持模糊查询
 - [POST /cloudphone/rpa/task/page](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/schedules/paths/~1cloudphone~1rpa~1task~1page/post.md)
 - [POST /cloudphone/rpa/task/save](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/schedules/paths/~1cloudphone~1rpa~1task~1save/post.md): 保存云手机计划任务。 templateParameter Parameter Specification 1. **Parameter Source** Parameter keys must be extracted from the `parameter` field returned by the following APIs: - Get market template pages -
 - [POST /cloudphone/rpa/onceTask/save](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/schedules/paths/~1cloudphone~1rpa~1oncetask~1save/post.md): 保存云端手机（已安排任务） 模板参数 参数规范 1. **参数来源** 参数键必须从以下 API 返回的 `parameter` 字段中提取： - 获取市场模板页面 - 获取个人模板页面 1. **数据结构** - 以 JSON 对象格式提交参数：`{"key1": "value1", "key2": "value2"}` - 最终参数值必须根据业务逻辑在使用前进行反序列化 1. **通用
 - [POST /cloudphone/rpa/task/cancel](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/schedules/paths/~1cloudphone~1rpa~1task~1cancel/post.md)
 - [POST /cloudphone/rpa/subTask/page](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/schedules/paths/~1cloudphone~1rpa~1subtask~1page/post.md): 查询时间表市场模板，模板名称支持模糊查询
 - [POST /cloudphone/rpa/subTask/detail/{id}](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/schedules/paths/~1cloudphone~1rpa~1subtask~1detail~1%7Bid%7D/post.md): 查询时间表市场模板，模板名称支持模糊查询
 - [POST /cloudphone/rpa/subTask/cancel/{id}](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/schedules/paths/~1cloudphone~1rpa~1subtask~1cancel~1%7Bid%7D/post.md)
## Touch

 - [POST /cloudphone/touch/click](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/touch/touchclick.md): 模拟手指单击云手机屏幕指定坐标位置。 坐标系以屏幕左上角为原点 `(0, 0)`，X 轴向右，Y 轴向下。
 - [POST /cloudphone/touch/doubleClick](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/touch/touchdoubleclick.md): 模拟手指双击云手机屏幕指定坐标位置。 坐标系以屏幕左上角为原点 `(0, 0)`，X 轴向右，Y 轴向下。
 - [POST /cloudphone/touch/longClick](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/touch/touchlongclick.md): 模拟手指长按云手机屏幕指定坐标位置。 可通过 `duration` 参数自定义长按持续时长（毫秒）。若不传则使用默认时长。 坐标系以屏幕左上角为原点 `(0, 0)`，X 轴向右，Y 轴向下。
 - [POST /cloudphone/touch/swipe](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/touch/touchswipe.md): 模拟手指从起始坐标滑动到结束坐标。 可通过 `duration` 参数控制滑动速度（毫秒），值越大滑动越慢。 坐标系以屏幕左上角为原点 `(0, 0)`，X 轴向右，Y 轴向下。
 - [POST /cloudphone/touch/drag](https://guide.morelogin.com/zh/api-reference/cloud-phone/open-api/touch/touchdrag.md): 模拟手指从起始坐标拖动到结束坐标。与滑动类似，但拖动通常用于拖拽图标、元素等场景。 可通过 `duration` 参数控制拖动速度（毫秒），值越大拖动越慢。 坐标系以屏幕左上角为原点 `(0, 0)`，X 轴向右，Y 轴向下。