Skip to content
Last updated

Khởi động, dừng, kết nối và quản lý môi trường trình duyệt đám mây theo cách lập trình thông qua API MoreLogin.


Tổng quan

API 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 giao thức Chrome DevTools (CDP) và điều khiển bằng các framework tự động hóa như Puppeteer, Playwright hoặc Selenium.

Trình duyệt đám mây hỗ trợ hai phương thức truy cập API:

Phương thứcBase URLTrường hợp sử dụng
API mở (từ xa)https://api.morelogin.comTruy cập từ mọi nơi, xác thực OAuth2
API cục bộ (cục bộ)http://127.0.0.1:40000Truy cập từ máy đang chạy ứng dụng MoreLogin

Chọn API mở nếu bạn cần truy cập từ xa hoặc tích hợp giữa các máy chủ. Chọn API cục bộ nếu bạn chạy tự động hóa trên cùng máy với ứng dụng MoreLogin.

Để biết chi tiết về xác thực, xem Xác thực.


Khả năng

Thao tácMô tả
Khởi độngKhởi động môi trường trình duyệt đám mây
DừngDừng môi trường đang chạy, có thể chọn buộc giải phóng
Phân trangTruy vấn môi trường theo trang với bộ lọc theo tên, nhóm và từ khóa
Kết nốiLấy địa chỉ CDP của môi trường đang chạy để kết nối công cụ tự động hóa

Quy trình điển hình

  1. Khởi động môi trường với envId. Môi trường chuyển sang trạng thái STARTING.
  2. Truy vấn định kỳ danh sách phân trang cho đến khi cloudBrowserStatusRUNNING.
  3. Kết nối để lấy cdpUrl, sau đó kết nối Puppeteer / Playwright / Selenium qua CDP.
  4. Dừng môi trường khi hoàn tất tự động hóa.

Trạng thái môi trường

Trạng tháiMô tả
STARTINGĐang khởi động
RUNNINGĐang chạy
CLOSEDĐã đóng

Thông tin kết nối

Endpoint kết nối trả về hai địa chỉ:

{
  "code": 0,
  "msg": null,
  "data": {
    "cdpUrl": "https://runtime1.morelogin.com:16167?token=c62fedaaac524e41a0f02fc4345d41cb",
    "accessUrl": "https://official-website.morelogin.com/browser-remote?token=eyJkZXNrdG9wVXJsIjoi...ZW52SWQiOiIyMDczMzk1NDg5NzM4OTE5OTM2In0%3D&envName=P-1267&lang=en-US"
  }
}
TrườngMô tả
cdpUrlEndpoint CDP kèm token truy cập. Truyền vào Puppeteer, Playwright hoặc Selenium.
accessUrlTrang máy tính từ xa trên nền web để xem và điều khiển phiên. Để trống nếu chưa được cấu hình.

token trong accessUrl là payload mã hóa Base64 chứa URL máy tính, token máy tính, thời hạn cùng ID của nhóm, người dùng, thành viên và môi trường. Hãy coi cả hai URL là thông tin xác thực và không chia sẻ chúng.


Tài liệu tham khảo API

APIMô tả
API mở Trình duyệt đám mâyTruy cập từ xa qua https://api.morelogin.com, xác thực OAuth2
API cục bộ Trình duyệt đám mâyTruy cập cục bộ qua http://127.0.0.1:40000, xác thực bằng token

Lưu ý: Cả hai API cung cấp các thao tác giống nhau. Đường dẫn API cục bộ dùng tiền tố /api/cloudbrowser/..., còn đường dẫn API mở dùng /cloudbrowser/.... Hãy luôn tham khảo tài liệu API tương ứng để biết đường dẫn và tham số chính xác.


Hướng dẫn liên quan

Hướng dẫnMô tả
Xác thựcThiết lập token OAuth2 (API mở) và xác thực bằng token (API cục bộ)
Bắt đầu nhanhThực hiện lệnh gọi API MoreLogin đầu tiên của bạn