Хмарний браузер

Запускайте, зупиняйте, підключайтеся та керуйте середовищами хмарного браузера програмно через 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