Перейти к содержимому
Справочник API
/
Браузер
/
/Cloud Runtime

Cloud Runtime

API для раздела «Cloud Runtime».

Operations

Запустить облачную среду выполнения

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
}