# Розширене створення профілю браузера Створює один профіль браузера з повною конфігурацією відбитка. - **Передумови**: ті самі перевірки тарифу та добової квоти, що й під час швидкого створення. Назва профілю має бути унікальною в команді, координати мають бути поза межами материкового Китаю, а `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 «Get Browser 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) Політика полотна. За замовчуванням: 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 = true, 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)