Saltar para o conteúdo
Referência da API
/
/
/
Atualizar impressão digit...

Atualizar impressão digital

Request

Regenera a impressão digital de um perfil de navegador.

  • Pré-requisitos: identifique o perfil por envId ou uniqueId. Perfis criptografados são rejeitados. Um perfil em execução não é bloqueado, mas a nova impressão digital vale a partir da próxima inicialização.
  • Efeito: gera uma impressão digital nova, aleatoriza o nome do host e o endereço MAC, e reassocia o kernel do navegador. Os valores informados na solicitação prevalecem sobre os gerados.
  • Conclusão: sincrônica.
  • Nova tentativa: nunca repita automaticamente. Cada chamada produz uma impressão digital aleatória diferente, então uma repetição às cegas depois de um timeout altera o perfil uma segunda vez. Compare antes com /env/detail.

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

Bodyapplication/jsonrequired
envIdstringrequired

ID do perfil (ID do ambiente). Deve ser fornecido exatamente um dos seguintes valores: envId ou uniqueId.

uniqueIdstring

Número de série do perfil (ID único). Deve ser fornecido exatamente um dos seguintes: envId ou uniqueId.

uaVersioninteger

Versão do User-Agent de destino (por exemplo, Chrome 129).

Se omitido, usa a versão atual do UA do perfil.

Example:129
browserTypeIdinteger

Tipo de navegador. 1 = Chrome, 2 = Firefox.

Enum:12
operatorSystemIdinteger

Tipo de sistema operacional. 1 = Windows, 2 = macOS, 3 = Android, 4 = iOS.

Enum:1234
advancedSettingobject(AdvancedSetting)

Configuração avançada de impressões digitais e comportamento do navegador.

curl -i -X POST \
  http://127.0.0.1:40000/api/env/fingerprint/refresh \
  -H 'Content-Type: application/json' \
  -d '{
    "envId": "1869988538611834880",
    "uniqueId": "",
    "uaVersion": 129,
    "browserTypeId": 1,
    "operatorSystemId": 2,
    "advancedSetting": {}
  }'

Responses

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

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