Перейти к содержимому
MultiloginБаза знаний

Как включить флаги для Mimic с помощью Postman

В Multilogin можно добавлять флаги Chromium в браузерные профили Mimic через Postman: передавайте их в объекте cmd_params поддерживаемого API-запроса. Это удобно, если нужно изменить поведение Chromium, например отключить уведомления или включить порт удаленной отладки.

➡️ В Postman откройте поддерживаемый эндпоинт профиля → «Body» → добавьте cmd_params в parameters → fingerprint → укажите флаг и, если нужно, его значение → нажмите «Send».

Флаги поддерживаются в эндпоинтах создания, обновления, частичного обновления профиля и запуска разового профиля.

Шаг 1: откройте Postman

Следуйте инструкциям в статье Как войти и обновить токен API Multilogin, чтобы:

  1. Получить доступ к документации API  в Documenter.
  2. Импортировать нашу коллекцию API в локальный Postman.
  3. Войдите в аккаунт и получите токен автоматизации

Эти действия можно выполнить с помощью скриптов, но в данном руководстве мы будем использовать Postman.

Шаг 2: выберите эндпоинт для запуска

Флаги можно добавить к следующим эндпоинтам:

В этой статье мы будем использовать эндпоинт POST Profile Create.

  1. Перейдите в папку «Profile Management» в рабочей области Postman и выберите эндпоинт POST Profile Create.
  2. Выберите вкладку «Body».
  3. Вставьте ваши значения в указанные ниже переменные в текст запроса:
    1. folder_id → найдите это значение, используя наши инструкции:
      1. DevTools 
      2. Postman 
      3. CLI (через команду list-folder)
    2. Заполните fingerprint → эти параметры необходимо указывать только в том случае, если соответствующие значения переменных установлены как custom

Следующий шаг будет связан с добавлением флагов во вкладке «Body».

Запрос Postman Profile Create: выбрана вкладка Body, флаги браузера показаны в JSON.

Шаг 3: добавьте флаги команды.

Флаги определяются как cmd_params. Они должны находиться в параметре fingerprints:

"cmd_params": {
                "params": [
                    {
                        "flag": "FLAG NAME",
                        "value": "FLAG VALUE"
                    }
                ]
            }

Вы можете обратиться к полному тексту запроса, в котором должно быть ясно, как правильно добавить флаги (замените <YOUR PROFILE NAME> и <YOUR FOLDER ID> ):

Полное тело запроса

{
    "name": "<YOUR PROFILE NAME>",
    "browser_type": "mimic",
    "core_version": 142,
     "folder_id": "<YOUR FOLDER ID>",
    "os_type": "windows",
    // "automation": "selenium",
    "is_headless": false,
    "parameters": {
        "flags": {
            "audio_masking": "mask",
            "fonts_masking": "custom",
            "geolocation_masking": "custom",
            "geolocation_popup": "prompt",
            "graphics_masking": "custom",
            "graphics_noise": "mask",
            "localization_masking": "custom",
            "media_devices_masking": "custom",
            "navigator_masking": "custom",
            "ports_masking": "mask",
            "proxy_masking": "custom",
            "quic_mode": "natural",
            "screen_masking": "custom",
            "timezone_masking": "custom",
            "webrtc_masking": "custom",
            "canvas_noise:": "custom",
            "startup_behavior": "custom"
        },
        "fingerprint": {
            "navigator": {
                "hardware_concurrency": 8,
                "platform": "Win32",
                "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
                "os_cpu": ""
            },
            "localization": {
                "languages": "en-US",
                "locale": "en-US",
                "accept_languages": "en-US,en;q=0.5"
            },
            "timezone": {
                "zone": "Asia/Bangkok"
            },
            "graphic": {
                "renderer": "ANGLE (NVIDIA, NVIDIA GeForce RTX 4070 Ti Direct3D11 vs_5_0 ps_5_0, D3D11)",
                "vendor": "Google Inc. (NVIDIA)"
            },
            "webrtc": {
                "public_ip": "123.123.123.123"
            },
            "media_devices": {
                "audio_inputs": 1,
                "audio_outputs": 1,
                "video_inputs": 2
            },
            "screen": {
                "height": 1200,
                "pixel_ratio": 1,
                "width": 1920
            },
            "geolocation": {
                "accuracy": 100,
                "altitude": 100,
                "latitude": 52.02,
                "longitude": -52.1
            },
            "ports": [
                12345
            ],
            "fonts": [
                "81938139"
            ],
            "cmd_params": {
                "params": [
                    {
                        "flag": "disable-background-timer-throttling"
                    },
                    {
                        "flag": "disable-backgrounding-occluded-windows"
                    },
                    {
                        "flag": "disable-renderer-backgrounding"
                    },
                    {
                        "flag": "disable-features",
                        "value": "CalculateNativeWinOcclusion"
                    },
                    {
                        "flag": "disable-component-update"
                    }
                ]
            }
        },
        "proxy": {
            "host": "host",
            "type": "http",
            "port": 8081,
            "username": "username",
            "password": "password"
        },
        "custom_start_urls": [
            "https://multilogin.com/ ",
            "https://whoerip.com/multilogin/ "
        ]
    }
} 

Важно! Если вы используете автоматизацию в своем скрипте, необходимо преобразовать ее в комментарий для правильной работы. Например:

// "automation": "selenium",

Кроме того, значения в теле запроса являются шаблонами. Отредактируйте или удалите любые дополнительные параметры, особенно те, которые связаны с прокси-сервером. Тело запроса не будет отправлено корректно без правильной настройки.

Шаг 4: отправьте запрос

После редактирования всех необходимых параметров (включая флаги) нажмите кнопку «Send».

Запрос Postman Profile Create: показаны JSON-тело и ответ 201 Created.

Пример использования: отключение уведомлений Chromium

Один из распространенных случаев использования флагов — отключение уведомлений Chromium. Для отключения уведомлений Chromium можно использовать флаг команды --disable-notifications. Эта опция полезна при использовании Multilogin в автоматизации.

Запрос разрешения на уведомления в браузере с кнопками Block и Allow.

Шаблон тела запроса с флагом disable-notification

{
    "name": "flag test",
    "browser_type": "mimic",
    "folder_id": "<YOUR FOLDER ID>",
    "os_type": "macos",
    "core_version": 142,
    "parameters": {
        "flags": {
            "audio_masking": "natural",
            "fonts_masking": "mask",
            "geolocation_masking": "mask",
            "geolocation_popup": "allow",
            "graphics_masking": "mask",
            "graphics_noise": "natural",
            "localization_masking": "mask",
            "media_devices_masking": "mask",
            "navigator_masking": "mask",
            "ports_masking": "natural",
            "proxy_masking": "disabled",
            "screen_masking": "natural",
            "timezone_masking": "mask",
            "webrtc_masking": "mask",
            "canvas_noise:": "disabled"
        },
        "storage": {
            "is_local": false
        },
        "fingerprint": {
            "cmd_params": {
                "params": [
                    {
                        "flag": "disable-notifications",
                        "value": "true"
                    }
                ]
            }
        }
    }
}

Пример использования: включение порта отладки.

Порт удаленной отладки полезен для автоматизации и поиска и устранения неисправностей.

Вот как это выглядит в фрагменте JSON:

"cmd_params": {
    "params": [
        {
            "flag": "remote-debugging-port",
            "value": "28481"
        }
    ]
}

Важно! Если вы используете автоматизацию в своем скрипте, необходимо преобразовать ее в комментарий для правильной работы. Например:

// "automation": "selenium",

Пример запроса

{
    "name": "profile name2",
    "browser_type": "mimic",
    "core_version": 142,
    "folder_id": "948bab9a-2cad-4a3f-af1f-01bfe260f85b",
    "os_type": "linux",
   // "automation": "selenium",
    "is_headless": false,
    "parameters": {
        "flags": {
            "audio_masking": "mask",
            "fonts_masking": "custom",
            "geolocation_masking": "custom",
            "geolocation_popup": "prompt",
            "graphics_masking": "custom",
            "graphics_noise": "mask",
            "localization_masking": "custom",
         

Значения в теле запроса являются шаблонами. Отредактируйте или удалите любые дополнительные параметры, особенно те, которые связаны с прокси-сервером. Тело запроса не будет отправлено корректно без правильной настройки.

После добавления этих значений запрос можно отправить в API. Нажмите кнопку «Отправить» в Postman.

Как проверить порт удаленной отладки

После редактирования и отправки запроса откройте профиль Mimic и перейдите по следующей ссылке: chrome://version/
Здесь вы должны увидеть порт удаленной отладки, указанный как 28481, что подтверждает активность конфигурации.

Страница версии браузера: показаны Command Line и флаги запуска браузера.

Чтобы предотвратить остановку фоновой активности браузером, примените следующие параметры запуска:

{
    ...
    "parameters": {
        ...
        "fingerprint": {
            ...
            "cmd_params": {
                "params": [
                    {
                        "flag": "disable-background-timer-throttling"
                    },
                    {
                        "flag": "disable-backgrounding-occluded-windows"
                    },
                    {
                        "flag": "disable-renderer-backgrounding"
                    },
                    {
                        "flag": "disable-features",
                        "value": "CalculateNativeWinOcclusion"
                    },
                    {
                        "flag": "disable-component-update"
                    }
                ]
            }
        }
    }
}

Эти флаги будут отправлены браузеру Mimic при запуске. Вот таблица флагов, используемых в данном случае:

Флаг Что это делает
--disable-background-timer-throttling Предотвращает снижение частоты фоновых таймеров JavaScript в Chromium.
--disable-backgrounding-occluded-windows Сохраняет вкладки активными, даже когда они не видны (например, свернуты или скрыты за другими окнами).
--disable-renderer-backgrounding Предотвращает снижение приоритета рендеринга фоновых вкладок со стороны Chromium.
--disable-features=CalculateNativeWinOcclusion Отключает функцию, которая обнаруживает и замедляет работу скрытых окон.
--disable-component-update Останавливает автоматическое обновление компонентов Chromium (например, Widevine, сертификатов и т. д.).

Будьте в курсе

Следите за обновлениями, общайтесь и смотрите примеры.

Открыть новостиКанал в TelegramЗадать вопросЧат в TelegramПосмотреть кейсыСообщество в Discord