# API mở Trình duyệt đám mây

Khởi động, dừng, kết nối và truy vấn môi trường trình duyệt đám mây MoreLogin thông qua API mở của MoreLogin.

Trình duyệt đám mây chạy một cấu hình trình duyệt MoreLogin trên máy chủ từ xa. Sau khi khởi động môi trường, bạn có thể kết nối đến nó qua CDP (giao thức Chrome DevTools) và điều khiển bằng các framework tự động hóa như Puppeteer hoặc Playwright.

**Base URL**: `https://api.morelogin.com`

Xác thực được thực hiện bằng token Bearer OAuth2. Xem [Xác thực](../Getting%20Started/authentication.md) để biết chi tiết.


Version: 1.0.0

## Servers

```
https://api.morelogin.com
```

## Download OpenAPI description

[API mở Trình duyệt đám mây](https://guide.morelogin.com/_bundle/@l10n/vi/API%20Reference/Cloud%20Browser/open-api.yaml)

## Cloud Browser

Khởi động, dừng, kết nối và truy vấn môi trường trình duyệt đám mây

### Khởi động trình duyệt đám mây

 - [POST /cloudbrowser/start](https://guide.morelogin.com/vi/api-reference/cloud-browser/open-api/cloud-browser/startcloudbrowser.md): Khởi động môi trường trình duyệt đám mây. Môi trường chuyển sang trạng thái STARTING và chuyển sang RUNNING khi trình duyệt từ xa đã sẵn sàng.

Quá trình khởi động là không đồng bộ. Hãy truy vấn định kỳ Phân trang môi trường trình duyệt đám mây để kiểm tra cloudBrowserStatus, sau đó gọi Kết nối trình duyệt đám mây khi môi trường ở trạng thái RUNNING.

### Dừng trình duyệt đám mây

 - [POST /cloudbrowser/stop](https://guide.morelogin.com/vi/api-reference/cloud-browser/open-api/cloud-browser/stopcloudbrowser.md): Dừng một môi trường trình duyệt đám mây đang chạy. Đặt force thành true để buộc giải phóng môi trường mà không chờ tắt máy êm.

### Phân trang môi trường trình duyệt đám mây

 - [POST /cloudbrowser/page](https://guide.morelogin.com/vi/api-reference/cloud-browser/open-api/cloud-browser/pagecloudbrowserenvironments.md): Truy vấn môi trường trình duyệt đám mây theo trang. Hỗ trợ lọc theo số thứ tự môi trường, ID môi trường, tên môi trường, từ khóa và nhóm.

### Kết nối trình duyệt đám mây

 - [POST /cloudbrowser/connect](https://guide.morelogin.com/vi/api-reference/cloud-browser/open-api/cloud-browser/connectcloudbrowser.md): Trả về thông tin kết nối của một môi trường trình duyệt đám mây đang chạy. Dùng cdpUrl được trả về để kết nối framework tự động hóa (Puppeteer, Playwright, Selenium) qua giao thức Chrome DevTools.

Môi trường phải ở trạng thái RUNNING. Nếu cần, hãy khởi động trước bằng Khởi động trình duyệt đám mây.