# Open API

Quản lý từ xa các profile trình duyệt và runtime trình duyệt trên cloud của MoreLogin thông qua MoreLogin Open API.

**URL cơ sở**: `https://api.morelogin.com`

Open API quản lý cùng các profile trình duyệt như Local API, nhưng không yêu cầu
client desktop của MoreLogin. Vì không có client cục bộ tham gia, Open API không thể mở trình duyệt
trên máy của bạn. Thay vào đó, nó có thể khởi động profile dưới dạng một **runtime trên cloud** chạy trên
hạ tầng của MoreLogin và được điều khiển qua Chrome DevTools Protocol (CDP).

| Khả năng | Local API | Open API |
| --- | --- | --- |
| Quản lý profile, proxy, nhóm, thẻ | Có | Có |
| Mở trình duyệt trên máy của bạn | Có | Không |
| Mở trình duyệt trên cloud của MoreLogin | Có | Có |

**Cách mã hóa ID**: ID của MoreLogin là số nguyên 64 bit trên server, nhưng được tuần tự hóa trong JSON dưới dạng
chuỗi thập phân để tránh mất độ chính xác trong JavaScript. Hãy gửi chúng dưới dạng chuỗi và đọc chúng dưới dạng chuỗi.

Xác thực dùng token Bearer OAuth2. Xem
[Xác thực](../Getting%20Started/authentication.md) để biết chi tiết.


Version: 2026-09-05

## Servers

[object Object]
```
https://api.morelogin.com
```

## Security

### OpenApiBearer

[object Object]

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

 - [Open API](https://guide.morelogin.com/_bundle/@l10n/vi/API%20Reference/Browser/open-api.yaml)

## Profiles

 - [POST /env/create/quick](https://guide.morelogin.com/vi/api-reference/browser/open-api/profiles/quickcreatebrowserprofileopenapi.md): Tạo từ 1 đến 200 profile trình duyệt dùng chung một cấu hình. - **Điều kiện tiên quyết**: gói của nhóm phải còn đủ số profile, và hạn mức tạo trong ngày chưa được dùng hết. `isEncrypt=1` yêu cầu nhóm
 - [POST /env/create/advanced](https://guide.morelogin.com/vi/api-reference/browser/open-api/profiles/advancedcreatebrowserprofileopenapi.md): Tạo một profile trình duyệt với cấu hình dấu vân tay đầy đủ. - **Điều kiện tiên quyết**: cùng các bước kiểm tra gói và hạn mức trong ngày như khi tạo nhanh. Tên profile phải là duy nhất trong nhóm, tọ
 - [POST /env/update](https://guide.morelogin.com/vi/api-reference/browser/open-api/profiles/updatebrowserprofileopenapi.md): Cập nhật một profile trình duyệt hiện có. Chỉ các trường xuất hiện trong yêu cầu bị thay đổi. - **Điều kiện tiên quyết**: profile phải tồn tại trong nhóm. Không thể cập nhật các profile được mã hóa đầ
 - [POST /env/page](https://guide.morelogin.com/vi/api-reference/browser/open-api/profiles/listbrowserprofilesopenapi.md): Liệt kê theo trang các profile trình duyệt mà thành viên đã xác thực nhìn thấy. - **Tác động**: không có. Chỉ đọc. An toàn khi thử lại với thời gian chờ tăng dần có giới hạn. - **Bộ lọc**: `keyword` k
 - [POST /env/detail](https://guide.morelogin.com/vi/api-reference/browser/open-api/profiles/getbrowserprofiledetailopenapi.md): Trả về toàn bộ cấu hình của một profile trình duyệt, gồm cả thiết lập dấu vân tay nâng cao và cookie. - **Điều kiện tiên quyết**: profile phải tồn tại trong nhóm và bên gọi phải có quyền với nó. - **T
 - [POST /env/removeToRecycleBin/batch](https://guide.morelogin.com/vi/api-reference/browser/open-api/profiles/batchremovebrowserprofilesopenapi.md): Chuyển một hoặc nhiều profile trình duyệt vào thùng rác. - **Điều kiện tiên quyết**: profile không được đang ở trong thùng rác, không được đang chạy, và không được đang trong quá trình chuyển giao. Hã
 - [POST /env/lock/query](https://guide.morelogin.com/vi/api-reference/browser/open-api/profiles/querybrowserprofilelockopenapi.md): Báo cho biết một profile trình duyệt hiện có đang bị thành viên khác trong nhóm chiếm giữ hay không. - **Tác động**: không có. Chỉ đọc. An toàn khi thử lại với thời gian chờ tăng dần có giới hạn. - **
 - [POST /env/setGroup/batch](https://guide.morelogin.com/vi/api-reference/browser/open-api/profiles/batchsetbrowserprofilegroupopenapi.md): Chuyển các profile trình duyệt vào một nhóm theo tên nhóm. - **Điều kiện tiên quyết**: cung cấp ít nhất một trong `envIds` hoặc `uniqueIds`; `groupName` là bắt buộc và tối đa 50 ký tự. Không có cách n
 - [POST /env/setProxy/batch](https://guide.morelogin.com/vi/api-reference/browser/open-api/profiles/batchsetbrowserprofileproxyopenapi.md): Gán proxy cho nhiều profile trình duyệt. - **Điều kiện tiên quyết**: cung cấp ít nhất một trong `envIds` hoặc `uniqueIds`. Nếu bạn truyền `proxyId`, nó phải đã tồn tại trong nhóm, nếu không lệnh gọi b
 - [POST /env/setRemark/batch](https://guide.morelogin.com/vi/api-reference/browser/open-api/profiles/batchsetbrowserprofileremarkopenapi.md): Đặt ghi chú cho nhiều profile trình duyệt. Chuỗi rỗng sẽ xóa ghi chú. - **Điều kiện tiên quyết**: cung cấp ít nhất một trong `envIds` hoặc `uniqueIds`; bên gọi phải có quyền với từng profile. - **Tác
## Cloud Runtime

 - [POST /cloudbrowser/start](https://guide.morelogin.com/vi/api-reference/browser/open-api/cloud-runtime/startcloudruntimeopenapi.md): Khởi động một profile trình duyệt dưới dạng runtime trên cloud. - **Điều kiện tiên quyết**: profile phải tồn tại trong nhóm của bạn và không được mã hóa đầu-cuối hay đang trong quá trình chuyển giao.
 - [POST /cloudbrowser/stop](https://guide.morelogin.com/vi/api-reference/browser/open-api/cloud-runtime/stopcloudruntimeopenapi.md): Dừng runtime trên cloud mà một profile đang chạy trong đó. - **Điều kiện tiên quyết**: phải có một lần chạy đang hoạt động do bạn khởi động cho profile đó. Gọi khi runtime đã dừng hoặc đang được giải
 - [POST /cloudbrowser/page](https://guide.morelogin.com/vi/api-reference/browser/open-api/cloud-runtime/pagecloudruntimesopenapi.md): Liệt kê các profile trình duyệt kèm trạng thái runtime trên cloud cho thành viên đang gọi. - **Tác động**: không có. Chỉ đọc. An toàn khi thử lại với thời gian chờ tăng dần có giới hạn. - **Giá trị tr
 - [POST /cloudbrowser/connect](https://guide.morelogin.com/vi/api-reference/browser/open-api/cloud-runtime/connectcloudruntimeopenapi.md): Trả về thông tin kết nối tới một runtime trên cloud đang chạy. - **Điều kiện tiên quyết**: runtime phải ở đúng trạng thái `RUNNING` và phải do chính bạn khởi động. Một runtime đang dừng hoặc đang lưu
## Fingerprint & Device Config

 - [POST /env/advanced/ua/versions](https://guide.morelogin.com/vi/api-reference/browser/open-api/fingerprint-and-device-config/listkernelversionsopenapi.md): Trả về các kernel trình duyệt đã phát hành và các phiên bản chính của user agent. - **Tác động**: không có. Chỉ đọc. An toàn khi thử lại với thời gian chờ tăng dần có giới hạn. - **Nội dung**: bề mặt
 - [POST /env/advanced/ua/get](https://guide.morelogin.com/vi/api-reference/browser/open-api/fingerprint-and-device-config/getuseragentopenapi.md): Sinh một user agent khớp với hệ điều hành và nhà sản xuất trình duyệt được yêu cầu. - **Điều kiện tiên quyết**: Firefox chỉ hợp lệ với Windows hoặc macOS, và `osVersion` phải là một trong các bản phát
 - [POST /env/base/resolution/list](https://guide.morelogin.com/vi/api-reference/browser/open-api/fingerprint-and-device-config/listresolutionsopenapi.md): Trả về các độ phân giải màn hình khả dụng cho một user agent hoặc hệ điều hành. - **Tác động**: không có. Chỉ đọc. An toàn khi thử lại với thời gian chờ tăng dần có giới hạn. - **Nội dung**: dữ liệu d
 - [POST /env/base/list](https://guide.morelogin.com/vi/api-reference/browser/open-api/fingerprint-and-device-config/listtimezonesandlanguagesopenapi.md): Trả về các múi giờ và ngôn ngữ khả dụng cho profile trình duyệt. - **Tác động**: không có. Chỉ đọc. An toàn khi thử lại với thời gian chờ tăng dần có giới hạn. - **Lưu ý**: hiện tại phản hồi không phụ
 - [POST /env/base/mobile/devices](https://guide.morelogin.com/vi/api-reference/browser/open-api/fingerprint-and-device-config/listmobiledevicesopenapi.md): Trả về các dòng thiết bị di động khả dụng cho profile trình duyệt Android và iOS. - **Tác động**: không có. Chỉ đọc. An toàn khi thử lại với thời gian chờ tăng dần có giới hạn. - **Nội dung**: phần gi
 - [POST /env/fingerprint/refresh](https://guide.morelogin.com/vi/api-reference/browser/open-api/fingerprint-and-device-config/refreshfingerprintopenapi.md): Sinh lại dấu vân tay của một profile trình duyệt. - **Điều kiện tiên quyết**: xác định profile bằng `envId` hoặc `uniqueId`. Profile đã mã hóa sẽ bị từ chối. Một profile đang chạy không bị chặn, nhưng
## Cache

 - [POST /env/cache/cleanCloud](https://guide.morelogin.com/vi/api-reference/browser/open-api/cache/cleancloudcacheopenapi.md): Xóa cache phía cloud của một profile trình duyệt. - **Điều kiện tiên quyết**: xác định profile bằng `envId` hoặc `uniqueId`, chọn ít nhất một loại cache, và profile không được đang trong quá trình chu