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

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


Докладніше про автентифікацію див. у розділі [Автентифікація](/uk/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 Хмарного браузера](/uk/api-reference/cloud-browser/open-api) | Віддалений доступ через `https://api.morelogin.com`, автентифікація OAuth2 |
| [Локальний API Хмарного браузера](/uk/api-reference/cloud-browser/local-api) | Локальний доступ через `http://127.0.0.1:40000`, автентифікація за токеном |


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


## Пов’язані посібники

| Посібник | Опис |
|  --- | --- |
| [Автентифікація](/uk/api-reference/getting-started/authentication) | Налаштування токена OAuth2 (Відкритий API) та автентифікація за токеном (Локальний API) |
| [Швидкий старт](/uk/api-reference/getting-started/quickstart) | Виконайте свій перший виклик API MoreLogin |