# Швидке створення профілю браузера

Створює від 1 до 200 профілів браузера зі спільною конфігурацією.
- **Передумови**
: у тарифі команди має залишитися достатньо профілів, а добова квота створення не має бути витрачена.
`isEncrypt=1`
 вимагає, щоб у команди був налаштований ключ шифрування. Firefox доступний лише на Windows та macOS.
`groupId`
 уже має існувати, але якщо замість нього передати
`groupName`
, групу буде створено автоматично.
- **Ефект**
: вставляє профілі, витрачає ємність тарифу та збільшує добовий лічильник створення. Передавання даних підключення проксі також може створити запис проксі.
- **Завершення**
: синхронне.
`data`
 містить ID нових профілів у порядку створення.
- **Повтор**
: не ідемпотентний, ключа ідемпотентності немає. Замість повтору підтвердьте результат через
`/env/page`
.
- **Local API**
: ядра-кандидати фільтруються за версією запущеного клієнта для робочого столу, а одночасні виклики від однієї команди серіалізуються блокуванням на рівні команди.

Задокументовані бізнес-помилки: `19002`, `19063`, `19064`, `19104`, `19106`, `19107`, `19108`, `19111`, `19112`, `14023`. Значення кодів див. у [Error Codes](/uk/api-reference/getting-started/error-codes). Будь-яка операція може додатково повернути загальні коди.

Endpoint: POST /api/env/create/quick
Version: 2026-09-05

## Request fields (application/json):

  - `browserTypeId` (integer, required)
    1: Chrome, 2: Firefox
    Example: 1

  - `groupId` (string)
    Ідентифікатор групи середовища; за замовчуванням: негрупований (0)
    Example: 0

  - `groupName` (string)
    Назва групи (макс. 50 символів). Якщо вказано, система спочатку перевіряє groupId: якщо знайдено дійсну групу, вона використовується; інакше виконується пошук за groupName. Якщо група з такою назвою існує, вона використовується; якщо ні — створюється нова. Кожна команда обмежена 1 000 групами.

  - `isEncrypt` (integer)
    Увімкнути наскрізне шифрування? 0: Ні, 1: Так; за замовчуванням: 0

  - `operatorSystemId` (integer, required)
    Тип ОС 1: Windows, 2: macOS, 3: Android, 4: iOS
    Example: 1

  - `quantity` (integer, required)
    Кількість середовищ для створення; діапазон: [1–50]
    Example: 1

  - `browserCore` (integer)
    Версія ядра браузера; за замовчуванням: 0 (автоматичне збігання). Отримайте доступні версії через '/api/env/advanced/ua/versions'
    Example: 140

  - `proxy` (object)
    Проксі

  - `proxy.skipDuplicateProxy` (boolean)
    Застосовується, якщо передано дані підключення без наявного `proxyId`. Якщо задано `true`, використовується відповідний проксі, а за відсутності збігу створюється новий запис. Якщо задано `false`, новий запис створюється навіть за наявності збігу.

  - `proxy.proxyId` (string)
    Ідентифікатор проксі-сервера

  - `proxy.proxyName` (string)
    Ім'я проксі-сервера (максимум 600 символів)

  - `proxy.proxyType` (integer)
    Тип проксі-сервера: 0: http, 1: https. Не може бути порожнім, якщо proxyProvider має значення 7/8.

  - `proxy.proxyProvider` (string)
    Проксі-Сервіс 0: http, 1: https, 2: socks5, 3: ssh, 4: Oxylabs, 5: Proxys.io, 7: Luminati, 8: Lumauto, 9: Oxylabsauto, 10: Trojan, 11: Shadowsocks, 13: ABCPROXY, 14: LunaProxy, 15: IPHTML, 16: PiaProxy, 17: 922S5, 18: 360Proxy

  - `proxy.proxyIp` (string)
    IP-адреса проксі-сервера. Може бути порожнім, якщо proxyProvider має значення 16/17/18; обов'язковий для інших.

  - `proxy.proxyPort` (integer)
    Проксі-порт (дозволені лише цифри 1-65535). Може бути порожнім, якщо proxyProvider має значення 16/17/18; обов'язковий для інших.

  - `proxy.username` (string)
    Ім'я користувача (максимум 200 символів)

  - `proxy.password` (string)
    Пароль (максимум 100 символів)

  - `proxy.refreshUrl` (string)
    Оновити URL-адресу

  - `proxy.country` (string)
    Країна (код країни див. у додатку). Обов'язково, якщо proxyProvider має значення 16/17/18

  - `proxy.city` (string)
    Місто

  - `proxy.state` (string)
    Штат/провінція

  - `proxy.encryptionType` (integer)
    Метод шифрування. Не може бути порожнім, якщо proxyProvider має значення 11. 1: aes-128-gcm, 2: aes-192-gcm, 3: aes-256-gcm, 4: aes-128-cfb, 5: aes-192-cfb, 6: aes-256-cfb, 7: aes-128-ctr, 8: aes-192-ctr, 9: aes-256-ctr, 10: rc4-md5, 11: chacha20-ietf, 12: xchacha20, 13: chacha20-ietf-poly1305, 14: xchacha20-ietf-poly1305

  - `proxy.ipMonitor` (boolean)
    Увімкнути моніторинг зміни IP-адреси? true: Увімк., false: Вимк.

  - `proxy.ipChangeAction` (integer)
    Моніторинг зміни IP-адреси 0: Блокувати доступ, 1: Попереджати

## Response 200:

  - `200` (unknown)
    Успіх. `data` — масив значень string; порожній масив, якщо повертати нічого.

## Response 200 fields (application/json):

  - `code` (integer, required)

  - `msg` (string | null, required)

  - `data` (array, required)

  - `requestId` (string, required)

