Kết nối môi trường chạy đám mây

Tài liệu tham khảo API

Kết nối môi trường chạy đám mây

Request

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 trữ sẽ bị từ chối, dù /cloudbrowser/page vẫn báo RUNNING.
Tác động: phát hành một token truy cập desktop mới và ghi nhận bạn là thành viên đang kết nối.
Gọi lặp lại: cdpUrl trả về là ổn định và các phiên CDP hiện có vẫn hoạt động, nhưng mỗi lần gọi lại phát hành một token desktop mới và ghi đè thành viên kết nối đã lưu. Các URL desktop trước đó không bị thu hồi, nên hãy coi mỗi URL trả về là một thông tin xác thực còn hiệu lực: không ghi vào log và không lưu trữ lại.
Giới hạn phiên: runtime tự động dừng khi đạt thời lượng tối đa, và quá trình lưu trữ bắt đầu ngay trước đó, nên một tiến trình tự động hóa chạy dài phải xử lý được việc runtime biến mất.
Dùng để: kết nối Puppeteer, Playwright hoặc Selenium tới cdpUrl.

Các mã lỗi nghiệp vụ đã ghi nhận: 40008, 40009, 40010. 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.

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 \
  http://127.0.0.1:40000/api/cloudbrowser/connect \
  -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"

dataobject(CloudBrowserConnectResult)required

Response

{
  "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"
  },
  "requestId": "1d4f3ea968664593860b94b35d4ebf5e"
}