# API cục bộ

API MoreLogin cung cấp giao diện RESTful toàn diện và thân thiện với nhà phát triển, cho phép quản lý lập trình hồ sơ trình duyệt, điện thoại đám mây và các tài nguyên liên quan. API cục bộ MoreLogin chạy trên máy tính của bạn và có thể truy cập tại: 127.0.0.1:40000

Version: 2026-09-05

## Servers

Local API
```
http://127.0.0.1:40000
```

## Download OpenAPI description

 - [API cục bộ](https://guide.morelogin.com/_bundle/@l10n/vi/API%20Reference/Browser/local-api.yaml)

## Profiles

 - [POST /api/env/create/quick](https://guide.morelogin.com/vi/api-reference/browser/local-api/profiles/createbrowserprofilequicklocal.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 /api/env/create/advanced](https://guide.morelogin.com/vi/api-reference/browser/local-api/profiles/createbrowserprofileadvancedlocal.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 /api/env/update](https://guide.morelogin.com/vi/api-reference/browser/local-api/profiles/updatebrowserprofilelocal.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 /api/env/removeToRecycleBin/batch](https://guide.morelogin.com/vi/api-reference/browser/local-api/profiles/batchdeletebrowserprofilesusingpost.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 /api/env/page](https://guide.morelogin.com/vi/api-reference/browser/local-api/profiles/listbrowserprofilesusingpost.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 /api/env/detail](https://guide.morelogin.com/vi/api-reference/browser/local-api/profiles/getbrowserprofiledetailsusingpost.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 /api/env/lock/query](https://guide.morelogin.com/vi/api-reference/browser/local-api/profiles/querybrowserlockstatususingpost.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 /api/env/setGroup/batch](https://guide.morelogin.com/vi/api-reference/browser/local-api/profiles/setbrowsergroupsbatchlocal.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 /api/env/setProxy/batch](https://guide.morelogin.com/vi/api-reference/browser/local-api/profiles/setbrowserproxiesbatchlocal.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 /api/env/setRemark/batch](https://guide.morelogin.com/vi/api-reference/browser/local-api/profiles/setbrowserremarksbatchlocal.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
## Runtime

 - [POST /api/env/start](https://guide.morelogin.com/vi/api-reference/browser/local-api/runtime/startbrowserprofileusingpost.md): Dùng để khởi tạo hồ sơ; bạn phải chỉ định ID hồ sơ. Sau khi khởi động thành công, bạn có thể truy cập giao diện gỡ lỗi hồ sơ để thực thi tự động hóa Selenium và Puppeteer. Đối với Selenium, hãy sử dụn
 - [POST /api/env/close](https://guide.morelogin.com/vi/api-reference/browser/local-api/runtime/closebrowserprofilelocal.md): Đóng một profile trình duyệt đang chạy. - **Nơi thực thi**: client desktop của MoreLogin xử lý hoàn toàn việc này trên máy của bạn. **Không có phần hiện thực ở phía server**, nên không tồn tại điều ki
 - [POST /api/env/status](https://guide.morelogin.com/vi/api-reference/browser/local-api/runtime/getbrowserprofilestatuslocal.md): Trả về trạng thái chạy hiện thời của một hoặc nhiều 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. - **Giá trị**: mỗi profile báo v
 - [POST /api/env/closeAll](https://guide.morelogin.com/vi/api-reference/browser/local-api/runtime/closeallbrowserprofileslocal.md): Đóng mọi profile trình duyệt mà client này đang chạy. - **Nơi thực thi**: client desktop của MoreLogin xử lý hoàn toàn việc này trên máy của bạn. **Không có phần hiện thực ở phía server**, nên không t
 - [POST /api/env/getAllProcessIds](https://guide.morelogin.com/vi/api-reference/browser/local-api/runtime/getallbrowserprocessidslocal.md): Liệt kê ID tiến trình của các profile trình duyệt đang chạy. - **Nơi thực thi**: client desktop của MoreLogin xử lý hoàn toàn việc này trên máy của bạn. **Không có phần hiện thực ở phía server**, nên
 - [POST /api/env/getAllDebugInfo](https://guide.morelogin.com/vi/api-reference/browser/local-api/runtime/getallbrowserdebuginfolocal.md): Liệt kê các endpoint gỡ lỗi của những profile trình duyệt đang chạy. - **Nơi thực thi**: client desktop của MoreLogin xử lý hoàn toàn việc này trên máy của bạn. **Không có phần hiện thực ở phía server
 - [POST /api/env/core/download](https://guide.morelogin.com/vi/api-reference/browser/local-api/runtime/downloadbrowserkernelslocal.md): Tải xuống và cài đặt nhân trình duyệt. Hỗ trợ tải xuống hàng loạt tối đa 20 nhân mỗi yêu cầu. Thời gian chờ cho thao tác này có thể lên đến khoảng 30 phút; bên gọi nên đặt thời gian chờ lớn hơn 1805 g
## Cloud Runtime

 - [POST /api/cloudbrowser/start](https://guide.morelogin.com/vi/api-reference/browser/local-api/cloud-runtime/startcloudruntimelocal.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 /api/cloudbrowser/stop](https://guide.morelogin.com/vi/api-reference/browser/local-api/cloud-runtime/stopcloudruntimelocal.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 /api/cloudbrowser/page](https://guide.morelogin.com/vi/api-reference/browser/local-api/cloud-runtime/pagecloudruntimeslocal.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 /api/cloudbrowser/connect](https://guide.morelogin.com/vi/api-reference/browser/local-api/cloud-runtime/connectcloudruntimelocal.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

 - [GET /api/env/advanced/ua/versions](https://guide.morelogin.com/vi/api-reference/browser/local-api/fingerprint-and-device-config/listadvanceduaversionslocal.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 /api/env/advanced/ua/get](https://guide.morelogin.com/vi/api-reference/browser/local-api/fingerprint-and-device-config/getbrowserprofileuausingpost.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 /api/env/base/resolution/list](https://guide.morelogin.com/vi/api-reference/browser/local-api/fingerprint-and-device-config/listresolutionsusingpost.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
 - [GET /api/system/platform/list](https://guide.morelogin.com/vi/api-reference/browser/local-api/fingerprint-and-device-config/listsystemplatformslocal.md): Trả về các nền tảng và site có thể gán cho một 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. - **Nội dung**: các nền tảng và site
 - [POST /api/env/base/list](https://guide.morelogin.com/vi/api-reference/browser/local-api/fingerprint-and-device-config/listtimezoneandlanguageusingpost.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 /api/env/fingerprint/refresh](https://guide.morelogin.com/vi/api-reference/browser/local-api/fingerprint-and-device-config/refreshfingerprintusingpost.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
 - [POST /api/env/base/mobile/devices](https://guide.morelogin.com/vi/api-reference/browser/local-api/fingerprint-and-device-config/listmobiledevicemodelslocal.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
## Cache & Window

 - [POST /api/env/removeLocalCache](https://guide.morelogin.com/vi/api-reference/browser/local-api/cache-and-window/clearlocalprofilecacheusingpost.md): Yêu cầu client MoreLogin cục bộ xóa dữ liệu cache 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` và chọn ít nhất một loại cache. Profile Firefox
 - [POST /api/env/cache/cleanCloud](https://guide.morelogin.com/vi/api-reference/browser/local-api/cache-and-window/cleancloudcachelocal.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
 - [POST /api/env/getAllScreen](https://guide.morelogin.com/vi/api-reference/browser/local-api/cache-and-window/getallbrowserscreenslocal.md): Liệt kê các màn hình mà client có thể sắp xếp cửa sổ lên. - **Nơi thực thi**: client desktop của MoreLogin xử lý hoàn toàn việc này trên máy của bạn. **Không có phần hiện thực ở phía server**, nên khô
 - [POST /api/env/arrangeWindows](https://guide.morelogin.com/vi/api-reference/browser/local-api/cache-and-window/arrangebrowserwindowslocal.md): Sắp xếp cửa sổ của các profile trình duyệt đang chạy trên màn hình. - **Nơi thực thi**: client desktop của MoreLogin xử lý hoàn toàn việc này trên máy của bạn. **Không có phần hiện thực ở phía server*