Saltar para o conteúdo

Modificar perfil do navegador

Request

Atualiza um perfil de navegador existente. Apenas os campos presentes na solicitação são alterados.

  • Pré-requisitos: o perfil precisa existir na equipe. Perfis com criptografia ponta a ponta não podem ser atualizados. O sistema operacional e o tipo de navegador não podem ser alterados. Um perfil em execução pode ser atualizado.
  • Efeito: grava o registro do perfil, as configurações expandidas dele e os cookies, e mescla as configurações avançadas de impressão digital (os valores existentes são mantidos salvo se sobrescritos).
  • Conclusão: sincrônica.
  • Nova tentativa: é seguro repetir com o mesmo corpo. Note que não há bloqueio otimista: atualizações simultâneas de um mesmo perfil são resolvidas pela última escrita, e a mesclagem da impressão digital lê antes de gravar, então chamadas simultâneas podem perder alterações.

Erros de negócio documentados: 19001, 19039, 19104, 19105, 19106, 19107, 19108, 19142, 19159, 19160, 19175, 19193. Consulte Error Codes para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

Bodyapplication/json
browserTypeIdinteger

ID do tipo de navegador; 1=Chrome, 2=Firefox

operatorSystemIdinteger

ID do tipo de SO; 1:Windows 2:macOS 3:Android 4:IOS 5:Linux

isEncryptinteger

Se o perfil deve ser criptografado; 0=Não, 1=Sim

startupParamsArray of strings

Parâmetros adicionais de inicialização do navegador

accountInfoobject(AccountInfo)

Informações da conta

advancedSettingobject(AdvancedSetting)

Configurações avançadas de impressão digital do navegador

afterStartupConfigobject(AfterStartupConfig)

Configurações após a inicialização

browserCoreinteger

Versão do kernel; padrão: 0 (correspondência automática). Obtenha as versões disponíveis em /api/env/advanced/ua/versions.

cookiesstring

String de cookies a pré-carregar (opcional)

envNamestring

Nome do ambiente

envRemarkstring

Observação do ambiente; comprimento máximo: 1500 caracteres

groupIdstring

ID do grupo de ambientes; padrão: sem grupo (0)

groupNamestring, <= 50 characters

Nome do grupo (máximo 50 caracteres). Se fornecido, o sistema primeiro verifica groupId: se um grupo válido for encontrado, ele é usado; caso contrário, pesquisa por groupName. Se um grupo com esse nome existir, ele é referenciado; se não, um novo grupo é criado. Cada equipe é limitada a 1.000 grupos.

proxyIdstring

ID do proxy; padrão: 0

tagIdsArray of strings

IDs de etiquetas; padrão: nenhuma

uaVersioninteger

Versão predefinida do UA; padrão: 0 (todas)

disableAudiointeger

Desativar áudio: 0 = não, 1 = sim

disableImginteger

Desativar o carregamento de imagens: 0 = não, 1 = sim

disableVideointeger

Desativar o carregamento de vídeo: 0 = não, 1 = sim

imgLimitSizeinteger

Tamanho máximo da imagem (KB)

envIdstringrequired

ID do ambiente

curl -i -X POST \
  http://127.0.0.1:40000/api/env/update \
  -H 'Content-Type: application/json' \
  -d '{
    "browserTypeId": 1,
    "operatorSystemId": 1,
    "isEncrypt": 1,
    "envId": "1661515884160372"
  }'

Responses

Sucesso. data é sempre null nesta operação; o resultado é informado por code.

Headers
any
Bodyapplication/json
codeintegerrequired
msgstring or nullrequired
datanullrequired
requestIdstringrequired
Response
{ "code": 0, "msg": null, "data": null, "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d" }