Pular para o conteúdo
MultiloginCentral de ajuda

Como habilitar os parâmetros de comando para Mimic com o Postman

No Multilogin, você pode adicionar flags do Chromium aos perfis de navegador Mimic pelo Postman, incluindo-as no objeto cmd_params de uma solicitação de API compatível. Use isso para alterar o comportamento do Chromium, como desativar notificações ou ativar uma porta de depuração remota.

➡️ No Postman, abra um endpoint de perfil compatível → “Body” → adicione cmd_params em parameters → fingerprint → insira a flag e o valor opcional → clique em “Send”.

As flags são compatíveis com os endpoints de criação, atualização, atualização parcial e início de perfis rápidos.

Passo 1: abra o Postman

Siga os passos descritos no artigo Como fazer login e atualizar seu token da API do Multilogin:

  1. Acesse nossa documentação API.
  2. Importe nossa coleção API para o seu Postman local.
  3. Faça login e obtenha seu token de automação

Essas ações podem ser realizadas em scripts, mas usaremos o Postman neste guia.

Etapa 2: escolha um ponto de extremidade para executar

Opções de comando que você pode adicionar aos seguintes endpoints:

Neste artigo, utilizaremos o endpoint POST Profile Create.

  1. Navegue até a pasta “Profile Management” no seu espaço de trabalho do Postman e selecione POST Profile Create
  2. Selecione a aba “Body”
  3. Insira seus valores nas variáveis abaixo no corpo da requisição:
    1. folder_id → encontre esse valor usando nossos guias:
      1. DevTools
      2. Postman
      3. CLI (via comando list-folder )
    2. Preencha fingerprint → esses parâmetros devem ser fornecidos somente se os sinalizadores correspondentes estiverem definidos como custom

O próximo passo será adicionar indicadores na aba “Body”.

Requisição Profile Create no Postman com Body selecionado e flags do navegador em JSON.

Passo 3: adicionar opções de comando

Os parâmetros de comando são definidos como cmd_params. Eles devem estar localizados no parâmetro fingerprints.

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

Você pode consultar o corpo completo da solicitação, que deve deixar claro como adicionar os parâmetros de comando corretamente (substitua <NOME DO SEU PERFIL> e <SEU FOLDER ID>):

Corpo da requisição completa

{
    "name": "<NOME DO SEU PERFIL>",
    "browser_type": "mimic",
    "core_version": 142,
     "folder_id": "<SEU 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/ "
        ]
    }
} 

Importante! Se você estiver usando automação em seu script, deverá transformá-la em um comentário para garantir a execução correta. Por exemplo:

// "automation": "selenium",

Além disso, os valores no corpo da requisição são espaços reservados. Edite ou remova quaisquer parâmetros extras, especialmente aqueles relacionados a proxy. O corpo da requisição não será enviado corretamente sem a configuração adequada.

Etapa 4: enviar a solicitação

Após editar todos os parâmetros necessários (incluindo os sinalizadores de comando - flags), clique no botão “Send”.

Requisição Profile Create no Postman mostrando corpo JSON e resposta 201 Created.

Caso de uso: desativar notificações do Chromium

Um dos casos comuns de uso de parâmetros de linha de comando é a desativação das notificações do Chromium. Você pode usar o parâmetro --disable-notifications para desativar as notificações do Chromium. Essa opção é útil ao usar Multilogin para automação.

Solicitação de permissão de notificações do navegador com botões Block e Allow.

Referência ao corpo da requisição, que contém o sinalizador disable-notification

{
    "name": "flag test",
    "browser_type": "mimic",
    "folder_id": "<SEU 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"
                    }
                ]
            }
        }
    }
}

Caso de uso: habilitar a porta de depuração

Uma porta de depuração remota é útil para automação e resolução de problemas.

Veja como fica no trecho JSON:

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

Importante! Se você estiver usando automação em seu script, deverá transformá-la em um comentário para garantir a execução correta. Por exemplo:

// "automation": "selenium",

Exemplo de solicitação

{
    "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",
            "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": "remote-debugging-port",
                        "value": "28481"
                    }
                ]
            }
        }
    }
}        

Os valores no corpo da requisição são espaços reservados. Edite ou remova quaisquer parâmetros extras, especialmente aqueles relacionados a proxy. O corpo da requisição não será enviado corretamente sem a configuração adequada.

Após adicionar esses valores, a solicitação pode ser enviada para a API. Clique no botão “Send” no Postman.

Como verificar a porta de depuração remota

Após editar e enviar a solicitação, abra o perfil Mimic e acesse o seguinte link: chrome://version/
Aqui, você deverá ver a Porta de Depuração Remota listada como 28481, confirmando que a configuração está ativa.

Página de versão do navegador mostrando Command Line e flags do navegador.

Para impedir que o navegador interrompa a atividade em segundo plano, aplique os seguintes argumentos de inicialização:

{
    ...
    "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"
                    }
                ]
            }
        }
    }
}

Essas flags serão passadas diretamente para a instância Mimic na inicialização. Aqui está a tabela de flags usadas para este caso de uso:

Sinalizador / Flag O que faz
--disable-background-timer-throttling Impede que o Chromium reduza a frequência dos temporizadores JavaScript em segundo plano.
--disable-backgrounding-occluded-windows Mantém as abas ativas mesmo quando não estão visíveis (por exemplo, minimizadas ou atrás de outras janelas).
--disable-renderer-backgrounding Impede que o Chromium reduza a prioridade das tarefas de renderização em abas em segundo plano.
--disable-features=CalculateNativeWinOcclusion Desativa a funcionalidade que detecta e reduz a velocidade de janelas ocultas ou sobrepostas.
--disable-component-update Impede as atualizações automáticas de componentes do Chromium (por exemplo, Widevine, certificados, etc.).

Fique por dentro

Veja as últimas atualizações, troque dicas e explore casos de uso práticos.

Novidades do produtoCanal no TelegramPergunte a outrosChat no TelegramExplore casos de usoComunidade no Discord