Saltar al contenido

Creación avanzada de perfil de navegador

Request

Crea un perfil de navegador con una configuración de huella completa.

  • Requisitos previos: las mismas comprobaciones de plan y cuota diaria que en la creación rápida. El nombre del perfil debe ser único dentro del equipo, las coordenadas deben quedar fuera de China continental, y advancedSetting.ua debe concordar con uaVersion. Si indicas un proxyId, ya debe existir en el equipo.
  • Efecto: inserta el perfil, sus credenciales de cuenta (cifradas en reposo) y la configuración posterior al arranque; consume capacidad del plan y el contador diario de creación. Una URL de plataforma personalizada también crea un registro de sitio.
  • Finalización: sincrónica. data contiene el ID del perfil nuevo.
  • Reintentos: no es idempotente. Una segunda llamada con el mismo envName explícito falla en la comprobación de unicidad; sin nombre, crea un duplicado. No hay clave de idempotencia. No reintentes a ciegas tras un timeout: consulta primero el estado.
  • Local API: los kernels candidatos se filtran por la versión del cliente de escritorio en ejecución, y las llamadas simultáneas de un mismo equipo se serializan mediante un bloqueo a nivel de equipo.

Errores de negocio documentados: 19001, 19002, 19004, 19005, 19063, 19064, 19100, 19101, 19102, 19103, 19104, 19105, 19106, 19107, 19108, 19109, 19110, 19111, 19112, 19141, 19175. Consulte Error Codes para el significado de cada código. Cualquier operación puede devolver además los códigos comunes.

Bodyapplication/json
browserTypeIdintegerrequired

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

operatorSystemIdintegerrequired

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

isEncryptinteger

Si se debe cifrar el perfil; 0=No, 1=Sí

startupParamsArray of strings

Parámetros adicionales de arranque del navegador

accountInfoobject(AccountInfo)

Información de la cuenta

advancedSettingobject(AdvancedSetting)

Ajustes avanzados de huella del navegador

afterStartupConfigobject(AfterStartupConfig)

Configuraciones posteriores al arranque

browserCoreinteger

Versión del kernel; por defecto: 0 (coincidencia automática). Obtén las versiones disponibles con /api/env/advanced/ua/versions.

cookiesstring

Cadena de cookies que se precargará (opcional)

envNamestring

Nombre del entorno

envRemarkstring

Comentario del entorno; longitud máxima: 1500 caracteres

groupIdstring

ID del grupo de entornos; por defecto: sin grupo (0)

groupNamestring, <= 50 characters

Nombre del grupo (máximo 50 caracteres). Si se proporciona, el sistema primero verifica groupId: si se encuentra un grupo válido, se utiliza; de lo contrario, busca por groupName. Si existe un grupo con ese nombre, se referencia; si no, se crea uno nuevo. Cada equipo está limitado a 1.000 grupos.

proxyIdstring

ID del proxy; por defecto: 0

tagIdsArray of strings

ID de etiquetas; por defecto: ninguna

uaVersioninteger

Versión preestablecida del UA; por defecto: 0 (todas)

disableAudiointeger

Desactivar audio: 0 = no, 1 = sí

disableImginteger

Desactivar la carga de imágenes: 0 = no, 1 = sí

disableVideointeger

Desactivar la carga de vídeo: 0 = no, 1 = sí

imgLimitSizeinteger

Tamaño máximo de imagen (KB)

proxyobject

Información del proxy

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

Responses

Correcto. data es un único valor cadena.

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