Облачный браузер

Запускайте, останавливайте, подключайтесь и управляйте средами облачного браузера программно через API MoreLogin.

Обзор

API Облачного браузера запускает профиль браузера MoreLogin на удалённом хосте. После запуска среды вы можете подключиться к ней по протоколу Chrome DevTools (CDP) и управлять ею с помощью фреймворков автоматизации, таких как Puppeteer, Playwright или Selenium.

Облачный браузер поддерживает два способа доступа к API:

Способ	Base URL	Сценарий использования
Открытый API (удалённый)	`https://api.morelogin.com`	Доступ из любого места, аутентификация OAuth2
Локальный API (локальный)	`http://127.0.0.1:40000`	Доступ с машины, на которой запущен клиент MoreLogin

Выберите Открытый API, если требуется удалённый доступ или интеграция между серверами. Выберите Локальный API, если автоматизация запускается на той же машине, что и клиент MoreLogin.

Подробности об аутентификации см. в разделе Аутентификация.

Возможности

Операция	Описание
Запуск	Запуск среды облачного браузера
Остановка	Остановка работающей среды, при необходимости с принудительным освобождением
Пагинация	Постраничный запрос сред с фильтрами по имени, группе и ключевому слову
Подключение	Получение CDP-адреса работающей среды для подключения инструментов автоматизации

Типичный сценарий

Запустите среду, указав envId. Среда переходит в состояние STARTING.
Опрашивайте постраничный список, пока cloudBrowserStatus не станет RUNNING.
Подключитесь, чтобы получить cdpUrl, затем подключите Puppeteer / Playwright / Selenium по CDP.
Остановите среду после завершения автоматизации.

Статус среды

Статус	Описание
`STARTING`	Запускается
`RUNNING`	Работает
`CLOSED`	Закрыта

Данные подключения

Эндпоинт подключения возвращает два адреса:

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

Поле	Описание
`cdpUrl`	CDP-эндпоинт с токеном доступа `token`. Передайте его в Puppeteer, Playwright или Selenium.
`accessUrl`	Страница удалённого рабочего стола в браузере для просмотра и управления сессией. Пусто, если не настроено.

Параметр token в accessUrl — это полезная нагрузка в кодировке Base64, содержащая URL рабочего стола, токен рабочего стола, срок действия, а также ID команды, пользователя, участника и среды. Считайте оба URL учётными данными и не передавайте их третьим лицам.

Справочник API

API	Описание
Открытый API Облачного браузера	Удалённый доступ через `https://api.morelogin.com`, аутентификация OAuth2
Локальный API Облачного браузера	Локальный доступ через `http://127.0.0.1:40000`, аутентификация по токену

Примечание: Оба API предоставляют одинаковые операции. Пути Локального API используют префикс /api/cloudbrowser/..., а пути Открытого API — /cloudbrowser/.... Точные пути и параметры всегда уточняйте в соответствующем справочнике API.

Связанные руководства

Руководство	Описание
Аутентификация	Настройка токена OAuth2 (Открытый API) и аутентификация по токену (Локальный API)
Быстрый старт	Выполните свой первый вызов API MoreLogin