Saltar al contenido

Iniciar entorno de ejecución en la nube

Request

Inicia un perfil de navegador como runtime en la nube.

  • Requisitos previos: el perfil debe existir en tu equipo y no puede estar cifrado de extremo a extremo ni en proceso de transferencia. Se exige un proxy y su accesibilidad se comprueba antes de aceptar el inicio. El kernel del navegador debe ser uno que el navegador en la nube admita, lo que descarta Firefox. Se aplican los límites de apertura del equipo y, en despliegues con la facturación del navegador en la nube activada, también se comprueba el saldo de créditos de IA.
  • Una ejecución por perfil: un miembro solo puede tener una ejecución activa por perfil. Cuando el equipo activa el bloqueo de seguridad, la ejecución de otro miembro bloquea la tuya.
  • Finalización: aceptado, no completado. data está vacío; el runtime se aprovisiona de forma asíncrona. Consulta /cloudbrowser/page hasta que cloudBrowserStatus sea RUNNING, y después llama a /cloudbrowser/connect para obtener cdpUrl. Un inicio puede aceptarse y fallar más tarde, lo que se ve en esa página.
  • Concurrencia: los inicios simultáneos de un perfil se serializan con un bloqueo; el que pierde se rechaza en lugar de ponerse en cola.
  • Reintentos: tras un timeout, lee /cloudbrowser/page; no reenvíes.

Errores de negocio documentados: 19039, 19065, 40001, 40003, 40015, 40016, 40021, 40023, 40024, 40025, 40026, 40027, 40028, 40029, 40037. Consulte Error Codes para el significado de cada código. Cualquier operación puede devolver además los códigos comunes.

Bodyapplication/jsonrequired
envIdstring(EnvironmentId)^[1-9]\d*$required

Browser profile (environment) ID. Serialized as a decimal string to avoid JavaScript precision loss on 64-bit integers.

Example:"1800000000000001"
curl -i -X POST \
  http://127.0.0.1:40000/api/cloudbrowser/start \
  -H 'Content-Type: application/json' \
  -d '{
    "envId": "1800000000000001"
  }'

Responses

Success

Bodyapplication/json
codeintegerrequired

Return result code. 0 means success; other codes indicate exceptions.

Example:0
msgstring or nullrequired

Error message. Usually null on success.

Example:null
requestIdstring

Operation request ID. This field may be present when the request passes through the API gateway.

Example:"1d4f3ea968664593860b94b35d4ebf5e"
datanull
Example:null
Response
{ "code": 0, "msg": null, "requestId": "1d4f3ea968664593860b94b35d4ebf5e", "data": null }