# Open API

Дистанційне керування профілями браузера та хмарними середовищами виконання MoreLogin через MoreLogin Open API.

**Базовий URL**: `https://api.morelogin.com`

Open API керує тими самими профілями браузера, що й Local API, але не потребує
десктопного клієнта MoreLogin. Оскільки локальний клієнт не задіяний, Open API не може запустити браузер
на вашій машині. Замість цього він може запустити профіль як **хмарне середовище виконання**, що працює на
інфраструктурі MoreLogin і керується через Chrome DevTools Protocol (CDP).

| Можливість | Local API | Open API |
| --- | --- | --- |
| Керування профілями, проксі, групами, мітками | Так | Так |
| Запуск браузера на вашій машині | Так | Ні |
| Запуск браузера у хмарі MoreLogin | Так | Так |

**Кодування ID**: ID у MoreLogin — це 64-бітні цілі числа на сервері, але в JSON вони серіалізуються як
десяткові рядки, щоб уникнути втрати точності в JavaScript. Надсилайте їх як рядки та читайте як рядки.

Автентифікація використовує bearer-токен OAuth2. Докладніше див.
[Автентифікація](../Getting%20Started/authentication.md).


Version: 2026-09-05

## Servers

[object Object]
```
https://api.morelogin.com
```

## Security

### OpenApiBearer

[object Object]

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

 - [Open API](https://guide.morelogin.com/_bundle/@l10n/uk/API%20Reference/Browser/open-api.yaml)

## Profiles

 - [POST /env/create/quick](https://guide.morelogin.com/uk/api-reference/browser/open-api/profiles/quickcreatebrowserprofileopenapi.md): Створює від 1 до 200 профілів браузера зі спільною конфігурацією. - **Передумови**: у тарифі команди має залишитися достатньо профілів, а добова квота створення не має бути витрачена. `isEncrypt=1` ви
 - [POST /env/create/advanced](https://guide.morelogin.com/uk/api-reference/browser/open-api/profiles/advancedcreatebrowserprofileopenapi.md): Створює один профіль браузера з повною конфігурацією відбитка. - **Передумови**: ті самі перевірки тарифу та добової квоти, що й під час швидкого створення. Назва профілю має бути унікальною в команді
 - [POST /env/update](https://guide.morelogin.com/uk/api-reference/browser/open-api/profiles/updatebrowserprofileopenapi.md): Оновлює наявний профіль браузера. Змінюються лише поля, присутні в запиті. - **Передумови**: профіль має існувати в команді. Профілі з наскрізним (end-to-end) шифруванням оновити неможливо. Операційну
 - [POST /env/page](https://guide.morelogin.com/uk/api-reference/browser/open-api/profiles/listbrowserprofilesopenapi.md): Посторінково виводить профілі браузера, видимі автентифікованому учаснику. - **Ефект**: відсутній. Лише читання. Повтор безпечний з обмеженою витримкою. - **Фільтрація**: `keyword` зіставляється з наз
 - [POST /env/detail](https://guide.morelogin.com/uk/api-reference/browser/open-api/profiles/getbrowserprofiledetailopenapi.md): Повертає повну конфігурацію одного профілю браузера, включно з розширеними налаштуваннями відбитка та cookie. - **Передумови**: профіль має існувати в команді, а той, хто викликає, має мати права на н
 - [POST /env/removeToRecycleBin/batch](https://guide.morelogin.com/uk/api-reference/browser/open-api/profiles/batchremovebrowserprofilesopenapi.md): Переміщує один або кілька профілів браузера до кошика. - **Передумови**: профіль не має вже бути в кошику, не має бути запущений і не має перебувати в процесі передавання. Спершу закрийте браузер. - *
 - [POST /env/lock/query](https://guide.morelogin.com/uk/api-reference/browser/open-api/profiles/querybrowserprofilelockopenapi.md): Повідомляє, чи зайнятий профіль браузера на цей момент іншим учасником команди. - **Ефект**: відсутній. Лише читання. Повтор безпечний з обмеженою витримкою. - **Семантика**: значення `true` вимагає в
 - [POST /env/setGroup/batch](https://guide.morelogin.com/uk/api-reference/browser/open-api/profiles/batchsetbrowserprofilegroupopenapi.md): Переміщує профілі браузера до групи за її назвою. - **Передумови**: укажіть хоча б одне з `envIds` або `uniqueIds`; `groupName` обов'язковий і не довший за 50 символів. Прибрати профіль із групи через
 - [POST /env/setProxy/batch](https://guide.morelogin.com/uk/api-reference/browser/open-api/profiles/batchsetbrowserprofileproxyopenapi.md): Прив'язує проксі до кількох профілів браузера. - **Передумови**: укажіть хоча б одне з `envIds` або `uniqueIds`. Якщо ви вказуєте `proxyId`, він уже має існувати в команді, інакше виклик відхиляється,
 - [POST /env/setRemark/batch](https://guide.morelogin.com/uk/api-reference/browser/open-api/profiles/batchsetbrowserprofileremarkopenapi.md): Задає примітку для кількох профілів браузера. Порожній рядок очищає її. - **Передумови**: укажіть хоча б одне з `envIds` або `uniqueIds`; той, хто викликає, має мати права на кожен профіль. - **Ефект*
## Cloud Runtime

 - [POST /cloudbrowser/start](https://guide.morelogin.com/uk/api-reference/browser/open-api/cloud-runtime/startcloudruntimeopenapi.md): Запускає профіль браузера як хмарне середовище виконання. - **Передумови**: профіль має існувати у вашій команді й не має бути зашифрований наскрізним шифруванням або перебувати в процесі передавання.
 - [POST /cloudbrowser/stop](https://guide.morelogin.com/uk/api-reference/browser/open-api/cloud-runtime/stopcloudruntimeopenapi.md): Зупиняє хмарне середовище виконання, у якому працює профіль. - **Передумови**: для цього профілю має існувати активний запуск, розпочатий вами. Виклик у момент, коли середовище вже зупинене або звільн
 - [POST /cloudbrowser/page](https://guide.morelogin.com/uk/api-reference/browser/open-api/cloud-runtime/pagecloudruntimesopenapi.md): Виводить профілі браузера разом зі станом хмарного середовища виконання для учасника, який викликає. - **Ефект**: відсутній. Лише читання. Повтор безпечний з обмеженою витримкою. - **Значення статусу*
 - [POST /cloudbrowser/connect](https://guide.morelogin.com/uk/api-reference/browser/open-api/cloud-runtime/connectcloudruntimeopenapi.md): Повертає дані підключення до запущеного хмарного середовища виконання. - **Передумови**: середовище має бути точно у стані `RUNNING` і має бути запущене саме вами. Середовище, яке зупиняється або архі
## Fingerprint & Device Config

 - [POST /env/advanced/ua/versions](https://guide.morelogin.com/uk/api-reference/browser/open-api/fingerprint-and-device-config/listkernelversionsopenapi.md): Повертає опубліковані ядра браузерів і мажорні версії user agent. - **Ефект**: відсутній. Лише читання. Повтор безпечний з обмеженою витримкою. - **Вміст**: поверхня Open API повертає лише опублікован
 - [POST /env/advanced/ua/get](https://guide.morelogin.com/uk/api-reference/browser/open-api/fingerprint-and-device-config/getuseragentopenapi.md): Генерує user agent, що відповідає запитаній операційній системі та виробнику браузера. - **Передумови**: Firefox допустимий лише з Windows або macOS, а `osVersion` має бути одним із підтримуваних випу
 - [POST /env/base/resolution/list](https://guide.morelogin.com/uk/api-reference/browser/open-api/fingerprint-and-device-config/listresolutionsopenapi.md): Повертає роздільності екрана, доступні для user agent або операційної системи. - **Ефект**: відсутній. Лише читання. Повтор безпечний з обмеженою витримкою. - **Вміст**: дані віддає служба базових дан
 - [POST /env/base/list](https://guide.morelogin.com/uk/api-reference/browser/open-api/fingerprint-and-device-config/listtimezonesandlanguagesopenapi.md): Повертає часові пояси та мови, доступні для профілів браузера. - **Ефект**: відсутній. Лише читання. Повтор безпечний з обмеженою витримкою. - **Примітка**: зараз відповідь не залежить від тіла запиту
 - [POST /env/base/mobile/devices](https://guide.morelogin.com/uk/api-reference/browser/open-api/fingerprint-and-device-config/listmobiledevicesopenapi.md): Повертає моделі мобільних пристроїв, доступні для профілів браузера Android та iOS. - **Ефект**: відсутній. Лише читання. Повтор безпечний з обмеженою витримкою. - **Вміст**: перетин таблиці пристроїв
 - [POST /env/fingerprint/refresh](https://guide.morelogin.com/uk/api-reference/browser/open-api/fingerprint-and-device-config/refreshfingerprintopenapi.md): Перегенеровує відбиток профілю браузера. - **Передумови**: укажіть профіль через `envId` або `uniqueId`. Зашифровані профілі відхиляються. Запущений профіль не блокується, але новий відбиток застосову
## Cache

 - [POST /env/cache/cleanCloud](https://guide.morelogin.com/uk/api-reference/browser/open-api/cache/cleancloudcacheopenapi.md): Очищає хмарний кеш профілю браузера. - **Передумови**: укажіть профіль через `envId` або `uniqueId`, виберіть хоча б один клас кешу, і профіль не має перебувати в процесі передавання. Локальний кеш кл