# 快速入门

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
  }'
```

*保存响应中的 `envId`（例如 `1993244721490239488`）。*

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

```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`。*

### 第二步：快速创建并启动云手机

```bash
curl -X POST "https://api.morelogin.com/cloudphone/newMachine" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "androidVersion": 10,
    "duration": 30,
    "unit": 1
  }'
```

*保存响应中的 `id`（云手机 ID）。*

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

假设您已经从应用程序库中获得了 `appVersionId`：

```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,  # Your Cloud Phone ID
    "appVersionId": "1672940217990530"
  }'
```

### 第 4 步：运行 RPA 计划

在您的新云手机上执行预先配置的自动化脚本：

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