Conectar ao ambiente de execução na nuvem

Referência da API

Conectar ao ambiente de execução na nuvem

Request

Retorna os dados de conexão de um runtime na nuvem em execução.

Pré-requisitos: o runtime precisa estar exatamente no estado RUNNING e ter sido iniciado por você. Um runtime que está sendo encerrado ou arquivado é rejeitado mesmo que /cloudbrowser/page ainda informe RUNNING.
Efeito: emite um novo token de acesso ao desktop e registra você como o membro conectado.
Chamadas repetidas: o cdpUrl retornado é estável e as sessões CDP existentes continuam funcionando, mas cada chamada emite um novo token de desktop e sobrescreve o membro conectado registrado. As URLs de desktop anteriores não são revogadas, então trate cada URL retornada como uma credencial ativa: não registre em logs nem persista.
Limite de sessão: o runtime é encerrado automaticamente ao atingir sua duração máxima, e o arquivamento começa um pouco antes, então uma automação de longa duração precisa lidar com o desaparecimento do runtime.
Uso: conecte Puppeteer, Playwright ou Selenium ao cdpUrl.

Erros de negócio documentados: 40008, 40009, 40010. Consulte Error Codes para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

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"
}