# 快速入门

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

## 浏览器自动化（本地 API）

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

### 先决条件

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


### 第 1 步：创建浏览器

```bash
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 步：启动浏览器并获取调试端口

```bash
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)

```javascript
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 步：关闭浏览器

```bash
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 步：获取访问令牌

```bash
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 步：创建云手机

```bash
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 步：启动云手机

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

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

### 第 4 步：安装应用程序

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

```bash
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`：

```bash
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`：

```bash
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`。模板在控制台中编写或从模板市场获取；接口只负责列出和运行模板。*

```bash
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](/zh/api-reference/browser/local-api) |
| 完整的云手机 API 参考 | [云手机 API](/zh/api-reference/cloud-phone/open-api) |
| 通过 ADB 连接 | [ADB 连接指南](/zh/api-reference/cloud-phone/adb) |