Підключитися до хмарного середовища виконання

Довідник API

Підключитися до хмарного середовища виконання

Request

Повертає дані підключення до запущеного хмарного середовища виконання.

Передумови: середовище має бути точно у стані RUNNING і має бути запущене саме вами. Середовище, яке зупиняється або архівується, відхиляється, навіть якщо /cloudbrowser/page усе ще повідомляє RUNNING.
Ефект: випускає новий токен доступу до робочого столу й записує вас як підключеного учасника.
Повторні виклики: повернений cdpUrl стабільний, наявні CDP-сесії продовжують працювати, але кожен виклик випускає новий токен робочого столу й перезаписує записаного підключеного учасника. Попередні URL робочого столу не відкликаються, тому вважайте кожен повернений URL дійсним секретом: не пишіть його в логи та не зберігайте.
Обмеження сесії: середовище автоматично зупиняється, коли досягає максимальної тривалості, а архівація починається трохи раніше, тому довготривала автоматизація повинна коректно переживати зникнення середовища.
Застосування: підключіть Puppeteer, Playwright або Selenium до cdpUrl.

Задокументовані бізнес-помилки: 40008, 40009, 40010. Значення кодів див. у Error Codes. Будь-яка операція може додатково повернути загальні коди.

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"
}