# Bắt đầu nhanh

Thiết lập và chạy với API MoreLogin sau 5 phút.

## Tự động hóa trình duyệt (API cục bộ)

**Kịch bản:** Tạo hồ sơ trình duyệt, khởi chạy nó, kết nối qua Puppeteer để chạy tập lệnh rồi dừng tập lệnh đó.

### Điều kiện tiên quyết

- Ứng dụng MoreLogin dành cho máy tính để bàn **v2.15.0++** được cài đặt và chạy cục bộ.
- Đã cài đặt Puppeteer (`npm i puppeteer-core`).


### Bước 1: Tạo hồ sơ trình duyệt

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

*Lưu `envId` từ phản hồi (ví dụ: `1993244721490239488`).*

### Bước 2: Khởi động hồ sơ và nhận cổng gỡ lỗi

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

*Câu trả lời sẽ bao gồm `debugPort` (ví dụ: `12345`).*

### Bước 3: Kết nối 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();
})();
```

### Bước 4: Dừng hồ sơ

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

## Quản lý điện thoại đám mây (API mở)

**Kịch bản:** Tạo nhanh điện thoại đám mây, khởi động, cài đặt ứng dụng và kích hoạt lịch trình RPA.

### Điều kiện tiên quyết

- ID API và Khóa API từ bảng điều khiển MoreLogin.


### Bước 1: Nhận Access Token

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

*Lưu `access_token` từ câu trả lời.*

### Bước 2: Tạo nhanh và khởi động Cloud Phone

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

*Lưu `id` (ID điện thoại đám mây) từ phản hồi.*

### Bước 3: Cài đặt ứng dụng

Giả sử bạn đã có `appVersionId` từ thư viện ứng dụng:

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

### Bước 4: Chạy lịch trình RPA

Thực thi tập lệnh tự động hóa được định cấu hình trước trên điện thoại đám mây mới của bạn:

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

## Tiếp theo là gì?

| Mục tiêu | đi tới |
|  --- | --- |
| Tài liệu tham khảo API hồ sơ trình duyệt đầy đủ | [API trình duyệt](/vi/api-reference/browser/local-api) |
| Tham chiếu API điện thoại đám mây đầy đủ | [API điện thoại đám mây](/vi/api-reference/cloud-phone/open-api) |
| Kết nối qua ADB | [Hướng dẫn kết nối ADB](/vi/api-reference/cloud-phone/adb) |