跳转到内容
API 参考
/
/
快速开始
Last updated

快速入门

5 分钟内即可启动并运行 MoreLogin API。

浏览器自动化（本地 API）

场景： 创建浏览器，启动它，通过 Puppeteer 连接以运行脚本，然后停止它。

先决条件

  • MoreLogin 桌面应用程序 v2.15.0+ 在本地安装并运行。
  • 已安装 Puppeteer (npm i puppeteer-core)。

第 1 步：创建浏览器

curl -X POST "http://127.0.0.1:40000/api/env/create/quick" \
  -H "Content-Type: application/json" \
  -d '{
    "browserTypeId": 1,
    "operatorSystemId": 1,
    "quantity": 1
  }'

该接口的 data 是新建浏览器 ID 的字符串数组。请取 data[0] 作为后续步骤的 envId（例如 1993244721490239488）。资源 ID 使用十进制字符串。

第 2 步：启动浏览器并获取调试端口

curl -X POST "http://127.0.0.1:40000/api/env/start" \
  -H "Content-Type: application/json" \
  -d '{"envId": "1993244721490239488"}'

响应将包含 debugPort（例如 12345）。

第 3 步：连接 Puppeteer (Node.js)

const puppeteer = require('puppeteer-core');

(async () => {
  const browser = await puppeteer.connect({
    browserURL: 'http://127.0.0.1:12345'
  });
  const page = await browser.newPage();
  await page.goto('https://www.morelogin.com');
  console.log(await page.title());
  await browser.disconnect();
})();

第 4 步：关闭浏览器

curl -X POST "http://127.0.0.1:40000/api/env/close" \
  -H "Content-Type: application/json" \
  -d '{"envId": "1993244721490239488"}'

云手机管理（开放API）

场景： 快速创建云手机，启动云手机，安装应用，触发RPA调度。

先决条件

  • MoreLogin 仪表板中的 API ID 和 API 密钥。
  • 第 1–3 步在全新账号上即可完成。第 4 步需要团队应用库中已有至少一个应用，第 5 步需要已有至少一个 RPA 模板；这两者都无法通过 API 创建，若查询结果为空请先在控制台中准备。

第 1 步：获取访问令牌

curl -X POST "https://api.morelogin.com/oauth2/token" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "YOUR_API_ID",
    "client_secret": "YOUR_API_KEY",
    "grant_type": "client_credentials"
  }'

保存响应中的 access_token。

第 2 步：创建云手机

curl -X POST "https://api.morelogin.com/cloudphone/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "skuId": "10002",
    "quantity": 1
  }'

将响应中的 data[0] 保存为云手机 ID。资源 ID 使用十进制字符串。

第 3 步：启动云手机

curl -X POST "https://api.morelogin.com/cloudphone/powerOn" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{"id": "1673823102599682"}'

开机是异步操作。成功响应仅表示请求已受理；执行依赖在线状态的命令前，请查询云手机列表直到设备进入可运行状态。

第 4 步：安装应用程序

应用从团队应用库安装，因此请先查询应用库中已有的内容：

curl -X POST "https://api.morelogin.com/cloudphone/app/page" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{"pageNum": 1, "pageSize": 10}'

请取 data.dataList[0].appVersionList[0].id 作为 appVersionId——版本按新版在前返回。应用层的 id 不是 install 需要的值。如果 data.dataList 为空，请先在 MoreLogin 控制台中上传应用；没有用于初始化应用库的接口。

可以按 appVersionId 安装，也可以在只知道包名时使用 packageName 加 versionCode：

curl -X POST "https://api.morelogin.com/cloudphone/app/install" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "id": "1673823102599682",
    "appVersionId": "1672940217990530"
  }'

第 5 步：运行 RPA 计划

列出您自己的模板，并取出需要运行的 id：

curl -X POST "https://api.morelogin.com/cloudphone/rpa/template/personal/page" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{"pageNo": 1}'

使用 data.dataList[0].id 作为下面的 templateId。模板在控制台中编写或从模板市场获取；接口只负责列出和运行模板。

curl -X POST "https://api.morelogin.com/cloudphone/rpa/onceTask/save" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "cloudPhoneId": "1673823102599682",
    "scheduleName": "Daily Login Task",
    "templateId": "987654321"
  }'

接下来是什么？

目标前往
完整的浏览器 API 参考浏览器 API
完整的云手机 API 参考云手机 API
通过 ADB 连接ADB 连接指南

Authentication

Common Response Format