Запустити хмарне середовище виконання

Довідник API

Запустити хмарне середовище виконання

Request

Запускає профіль браузера як хмарне середовище виконання.

Передумови: профіль має існувати у вашій команді й не має бути зашифрований наскрізним шифруванням або перебувати в процесі передавання. Проксі обовʼязковий, і його досяжність перевіряється до прийняття запуску. Ядро браузера має підтримуватися хмарним браузером, що виключає Firefox. Застосовуються командні ліміти на кількість відкритих сесій, а в розгортаннях з увімкненою тарифікацією хмарного браузера додатково перевіряється баланс кредитів ШІ.
Один запуск на профіль: учасник може мати лише один активний запуск на профіль. Коли команда вмикає блокування безпеки, запуск іншого учасника блокує ваш.
Завершення: прийнято, але не завершено. data порожній; середовище виконання готується асинхронно. Опитуйте /cloudbrowser/page, доки cloudBrowserStatus не стане RUNNING, потім викличте /cloudbrowser/connect для отримання cdpUrl. Запуск може бути прийнятий і все одно згодом провалитися — це відображається на тій самій сторінці.
Паралельність: одночасні запуски одного профілю серіалізуються блокуванням; той, хто програв, відхиляється, а не ставиться в чергу.
Повтор: після таймауту читайте /cloudbrowser/page — не надсилайте запит повторно.

Задокументовані бізнес-помилки: 19039, 19065, 40001, 40003, 40015, 40016, 40021, 40023, 40024, 40025, 40026, 40027, 40028, 40029, 40037. Значення кодів див. у 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/start \
  -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
}