# Расширенные настройки создания профиля браузера Создаёт один профиль браузера с полной конфигурацией отпечатка. - **Предварительные условия**: те же проверки тарифа и суточной квоты, что и при быстром создании. Имя профиля должно быть уникальным в команде, координаты должны находиться вне материкового Китая, а `advancedSetting.ua` должен согласовываться с `uaVersion`. Если вы указываете `proxyId`, он уже должен существовать в команде. - **Эффект**: вставляет профиль, его учётные данные (зашифрованные при хранении) и конфигурацию после запуска; расходует ёмкость тарифа и суточный счётчик создания. Пользовательский URL платформы также создаёт запись сайта. - **Завершение**: синхронное. `data` содержит ID нового профиля. - **Повтор**: не идемпотентен. Второй вызов с тем же явно указанным `envName` не пройдёт проверку уникальности; без имени он создаст дубликат. Ключа идемпотентности нет. Не повторяйте слепо после таймаута: сначала запросите состояние. - **Local API**: ядра-кандидаты фильтруются по версии запущенного клиента для рабочего стола, а одновременные вызовы от одной команды сериализуются блокировкой на уровне команды. Задокументированные бизнес-ошибки: `19001`, `19002`, `19004`, `19005`, `19063`, `19064`, `19100`, `19101`, `19102`, `19103`, `19104`, `19105`, `19106`, `19107`, `19108`, `19109`, `19110`, `19111`, `19112`, `19141`, `19175`. Значения кодов см. в [Error Codes](../Getting%20Started/error-codes.md). Любая операция может дополнительно вернуть общие коды. Endpoint: POST /api/env/create/advanced Version: 2026-09-05 ## Request fields (application/json): - `browserTypeId` (integer, required) ID типа браузера; 1=Chrome, 2=Firefox - `operatorSystemId` (integer, required) ID типа ОС; 1:Windows 2:macOS 3:Android 4:IOS 5:Linux - `isEncrypt` (integer) Шифровать ли профиль; 0=нет, 1=да - `startupParams` (array) Дополнительные параметры запуска браузера - `accountInfo` (object) - `accountInfo.customerUrl` (string) Пользовательский URL платформы — обязателен, если platformId=9999, должен быть действительным URL-адресом. - `accountInfo.password` (string) Пароль; максимальная длина: 50 символов. - `accountInfo.platformId` (string) Идентификатор платформы; используйте 9999 для пользовательского URL. См. /api/system/platform/list. - `accountInfo.siteId` (string) Идентификатор сайта; получить через API «Получить настраиваемые платформы» (/api/system/platform/list) - `accountInfo.username` (string) Имя пользователя; максимальная длина: 64 символа. - `advancedSetting` (object) Расширенные настройки идентификации браузера и его поведения. - `advancedSetting.ua` (string) Настройка User-Agent (UA) профиля. Должен соответствовать стандартному формату UA. Доступно через API «Получить UA браузера». - `advancedSetting.time_zone` (object) - `advancedSetting.time_zone.switcher` (integer) Параметр часового пояса. По умолчанию: 1. 1 = Соответствие IP-адресу, 2 = Пользовательский. - `advancedSetting.time_zone.value` (string) Требуется, если switcher=2. Идентификатор часового пояса из API «Получить список часовых поясов и языков». - `advancedSetting.web_rtc` (object) - `advancedSetting.web_rtc.switcher` (integer) Политика WebRTC. По умолчанию: 2. 1 = Конфиденциальность, 2 = Замена, 3 = Реальный, 4 = Отключено, 5 = Переадресация. - `advancedSetting.geo_location` (object) - `advancedSetting.geo_location.switcher` (integer) Политика геолокации. По умолчанию: 1. 1 = Запрос, 2 = Отключено. - `advancedSetting.geo_location.base_on_ip` (boolean) Определять местоположение по IP-адресу? По умолчанию: true. true = запрос, false = вручную. - `advancedSetting.geo_location.latitude` (number) Широта. Обязательно, если base_on_ip=false. - `advancedSetting.geo_location.longitude` (number) Долгота. Обязательно, если base_on_ip=false. - `advancedSetting.geo_location.accuracy` (number) Точность в метрах. Требуется, если base_on_ip=false. - `advancedSetting.language` (object) - `advancedSetting.language.switcher` (integer) Языковая политика. По умолчанию: 1. 1 = Соответствие IP-адресу, 2 = Пользовательский. - `advancedSetting.language.value` (string) Обязательно, если switcher=2. Идентификаторы языков, разделенные запятыми, из API «Получить список часовых поясов и языков». - `advancedSetting.resolution` (object) - `advancedSetting.resolution.switcher` (integer) Политика разрешения. По умолчанию: 1. 1 = Реальное, 2 = Пользовательское. - `advancedSetting.resolution.id` (string) Обязательно, если switcher=2. Идентификатор разрешения из API «Получить список разрешений». - `advancedSetting.font` (object) - `advancedSetting.font.switcher` (integer) Политика шрифтов. По умолчанию: 1. 1 = Настоящий, 2 = Пользовательский. - `advancedSetting.font.value` (string) Названия пользовательских шрифтов, разделённые запятыми (обязательно, если switcher=2). - `advancedSetting.canvas` (object) - `advancedSetting.canvas.switcher` (integer) Политика Canvas. По умолчанию: 1. 1 = Шум, 2 = Реальный. - `advancedSetting.webgl_image` (object) - `advancedSetting.webgl_image.switcher` (integer) Политика обработки изображений WebGL. По умолчанию: 1. 1 = Шум, 2 = Реальный. - `advancedSetting.webgl_metadata` (object) - `advancedSetting.webgl_metadata.switcher` (integer) Политика метаданных WebGL. По умолчанию: 3. 1 = Реальное ускорение, 2 = Отключить аппаратное ускорение, 3 = Пользовательское ускорение. - `advancedSetting.webgl_metadata.provider` (string) Строка сервиса WebGL (например, "Google Inc.") - `advancedSetting.webgl_metadata.render` (string) Строка рендеринга WebGL (например, "ANGLE (...)") - `advancedSetting.audio_context` (object) - `advancedSetting.audio_context.switcher` (integer) Политика AudioContext. По умолчанию: 1. 1 = Шум, 2 = Реалистичный. - `advancedSetting.media_device` (object) - `advancedSetting.media_device.switcher` (integer) Политика медиаустройства. По умолчанию: 1. 1 = Шум, 2 = Реальный. - `advancedSetting.client_rects` (object) - `advancedSetting.client_rects.switcher` (integer) Политика ClientRects. По умолчанию: 1. 1 = Шум, 2 = Реальный. - `advancedSetting.speech_voise` (object) - `advancedSetting.speech_voise.switcher` (integer) Политика SpeechVoices. По умолчанию: 1. 1 = Конфиденциальность, 2 = Реальность - `advancedSetting.hardware_concurrency` (integer) Имитируемое количество логических ядер ЦП. По умолчанию: 4. Варианты: 0 (реальное), 2, 3, 4, 6, 8, 10, 12. - `advancedSetting.memery_device` (integer) Имитируемая память устройства (ГБ). По умолчанию: 8. Варианты: 0 (реальное значение), 2, 4, 6, 8. - `advancedSetting.do_not_track` (integer) Настройка «Не отслеживать». Значение по умолчанию: 2. 1 = включено, 2 = выключено. - `advancedSetting.bluetooth` (object) - `advancedSetting.bluetooth.switcher` (integer) Политика Bluetooth. По умолчанию: 1. 1 = Конфиденциальность, 2 = Аутентичность. - `advancedSetting.battery` (object) - `advancedSetting.battery.switcher` (integer) Политика использования батареи. По умолчанию: 1. 1 = Конфиденциальность, 2 = Подлинность. - `advancedSetting.port_scan_protection` (object) - `advancedSetting.port_scan_protection.switcher` (integer) Защита от сканирования портов. По умолчанию: 1. 1 = Вкл., 2 = Выкл. - `advancedSetting.port_scan_protection.value` (string) Разрешено подключение локальных сетевых портов (разделенных запятыми). - `advancedSetting.os_version` (string) Версия системы macOS (например, macOS 12, macOS 13, macOS 14). - `advancedSetting.web_gpu` (object) - `advancedSetting.web_gpu.switcher` (integer) Политика WebGPU. По умолчанию: 1. 1 = сопоставление на основе WebGL, 2 = истинно, 3 = отключено. - `advancedSetting.ciphers` (object) - `advancedSetting.ciphers.switcher` (integer) Политика шифрования TLS. По умолчанию: 1. 1 = По умолчанию, 2 = Пользовательская. - `advancedSetting.ciphers.value` (string) Обязательно, если switcher=2. Список протоколов TLS, разделенных запятыми, для отключения (например, "TLSv1,TLSv1.1"). - `advancedSetting.mobile_device` (string) Идентификатор модели телефона (в виде строки). Получить с помощью API "Получить список моделей телефонов". Пример: "1826502391344832512" - `afterStartupConfig` (object) - `afterStartupConfig.afterStartup` (integer) Действие после запуска. По умолчанию: 1. 1 = Продолжить просмотр последней страницы, 2 = Открыть указанные URL-адреса, 3 = Открыть URL-адреса + платформа, 4 = Продолжить просмотр последней страницы + платформа. - `afterStartupConfig.autoOpenUrls` (array) Список допустимых URL-адресов для автоматического открытия (обязательно для вариантов 2–3). - `browserCore` (integer) Версия ядра; по умолчанию: 0 (автоподбор). Доступные версии можно получить через `/api/env/advanced/ua/versions`. - `cookies` (string) Строка cookie для предварительной загрузки (необязательно) - `envName` (string) Название окружения - `envRemark` (string) Примечание к окружению; максимальная длина: 1500 символов - `groupId` (string) ID группы окружений; по умолчанию: без группы (0) - `groupName` (string) Название группы (макс. 50 символов). Если указано, система сначала проверяет groupId: если найдена действительная группа, она используется; в противном случае выполняется поиск по groupName. Если группа с таким именем существует, она используется; если нет — создаётся новая. Каждая команда ограничена 1 000 группами. - `proxyId` (string) ID прокси; по умолчанию: 0 - `tagIds` (array) ID меток; по умолчанию: нет - `uaVersion` (integer) Предустановленная версия UA; по умолчанию: 0 (все) - `disableAudio` (integer) Отключить звук: 0 = нет, 1 = да - `disableImg` (integer) Отключить загрузку изображений: 0 = нет, 1 = да - `disableVideo` (integer) Отключить загрузку видео: 0 = нет, 1 = да - `imgLimitSize` (integer) Максимальный размер изображения (КБ) - `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) Код страны (например `us`). Поддерживаемые коды см. в [таблице стран и часовых поясов](/api-reference/appendix/country-time-zone). Обязателен, когда 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` (string, required) - `requestId` (string, required)