Skip to content
Tài liệu tham khảo API
/
Trình duyệt
/
/Cloud Runtime

Cloud Runtime

Khởi động, dừng, truy vấn và kết nối các profile trình duyệt đang chạy trên cloud của MoreLogin.

Operations

Khởi động runtime trên cloud

Request

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. Bắt buộc phải có proxy và khả năng kết nối của nó được kiểm tra trước khi lệnh khởi động được tiếp nhận. Kernel trình duyệt phải là loại mà cloud browser hỗ trợ, điều này loại trừ Firefox. Giới hạn số phiên mở của nhóm được áp dụng, và trên các bản triển khai có bật tính phí cloud browser thì số dư credit AI cũng được kiểm tra.
  • Một lượt chạy cho mỗi profile: mỗi thành viên chỉ có thể có một lượt chạy đang hoạt động cho mỗi profile. Khi nhóm bật khóa bảo mật, lượt chạy của thành viên khác sẽ chặn lượt của bạn.
  • Hoàn tất: đã tiếp nhận, chưa hoàn tất. data rỗng; runtime được cấp phát không đồng bộ. Hãy hỏi vòng /cloudbrowser/page cho đến khi cloudBrowserStatus là RUNNING, rồi gọi /cloudbrowser/connect để lấy cdpUrl. Một lệnh khởi động có thể được tiếp nhận rồi vẫn thất bại về sau, và điều đó hiện ra ở trang này.
  • Đồng thời: các lệnh khởi động đồng thời cho cùng một profile được xếp tuần tự bằng khóa; bên thua bị từ chối chứ không xếp hàng đợi.
  • Thử lại: sau khi hết thời gian chờ, hãy đọc /cloudbrowser/page — đừng gửi lại.

Các mã lỗi nghiệp vụ đã ghi nhận: 19039, 19065, 40001, 40003, 40015, 40016, 40021, 40023, 40024, 40025, 40026, 40027, 40028, 40029, 40037. Xem Error Codes để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

Security
OpenApiBearer
Bodyapplication/jsonrequired
envIdstring(EnvironmentId)^[1-9]\d*$required

Browser profile (environment) ID. Serialized as a decimal string to avoid JavaScript precision loss on 64-bit integers.

Example:"1800000000000001"
curl -i -X POST \
  https://api.morelogin.com/cloudbrowser/start \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "envId": "1800000000000001"
  }'

Responses

Success

Bodyapplication/json
codeintegerrequired

Return result code. 0 means success; other codes indicate exceptions.

Example:0
msgstring or nullrequired

Error message. Usually null on success.

Example:null
requestIdstring

Operation request ID. This field may be present when the request passes through the API gateway.

Example:"1d4f3ea968664593860b94b35d4ebf5e"
datanull
Example:null
Response
{
  "code": 0,
  "msg": null,
  "requestId": "1d4f3ea968664593860b94b35d4ebf5e",
  "data": null
}