Saltar al contenido

Conectar con el entorno de ejecución en la nube

Request

Devuelve los datos de conexión de un runtime en la nube que está en ejecución.

  • Requisitos previos: el runtime debe estar exactamente en estado RUNNING y lo debes haber iniciado tú. Un runtime que se está deteniendo o archivando se rechaza aunque /cloudbrowser/page siga informando RUNNING.
  • Efecto: emite un token de acceso al escritorio nuevo y te registra como el miembro conectado.
  • Llamadas repetidas: el cdpUrl devuelto es estable y las sesiones CDP existentes siguen funcionando, pero cada llamada emite un token de escritorio nuevo y sobrescribe el miembro conectado registrado. Las URL de escritorio anteriores no se revocan, así que trata cada URL devuelta como una credencial activa: no las registres en logs ni las persistas.
  • Límite de sesión: el runtime se detiene automáticamente al alcanzar su duración máxima, y el archivado empieza algo antes, por lo que una automatización de larga duración debe contemplar que el runtime desaparezca.
  • Uso: conecta Puppeteer, Playwright o Selenium a cdpUrl.

Errores de negocio documentados: 40008, 40009, 40010. 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/connect \
  -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"
dataobject(CloudBrowserConnectResult)required
Response
{ "code": 0, "msg": null, "data": { "cdpUrl": "https://runtime1.morelogin.com:16167?token=c62fedaaac524e41a0f02fc4345d41cb", "accessUrl": "https://official-website.morelogin.com/browser-remote?token=eyJkZXNrdG9wVXJsIjoi...ZW52SWQiOiIyMDczMzk1NDg5NzM4OTE5OTM2In0%3D&envName=P-1267&lang=en-US" }, "requestId": "1d4f3ea968664593860b94b35d4ebf5e" }