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

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


Подробности об аутентификации см. в разделе [Аутентификация](/ru/api-reference/getting-started/authentication).

## Возможности

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


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

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


## Статус среды

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


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

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

```json
{
  "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 Облачного браузера](/ru/api-reference/cloud-browser/open-api) | Удалённый доступ через `https://api.morelogin.com`, аутентификация OAuth2 |
| [Локальный API Облачного браузера](/ru/api-reference/cloud-browser/local-api) | Локальный доступ через `http://127.0.0.1:40000`, аутентификация по токену |


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


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

| Руководство | Описание |
|  --- | --- |
| [Аутентификация](/ru/api-reference/getting-started/authentication) | Настройка токена OAuth2 (Открытый API) и аутентификация по токену (Локальный API) |
| [Быстрый старт](/ru/api-reference/getting-started/quickstart) | Выполните свой первый вызов API MoreLogin |