# Быстрое создание профиля браузера

Создаёт от 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](../Getting%20Started/error-codes.md). Любая операция может дополнительно вернуть общие коды.

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)
    Идентификатор группы среды; по умолчанию: ungrouped (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.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)