Saltar para o conteúdo
Referência da API
/
Navegador
/
/Cloud Runtime

Iniciar ambiente de execução na nuvem

Request

Inicia um perfil de navegador como runtime na nuvem.

  • Pré-requisitos: o perfil precisa existir na sua equipe e não pode estar criptografado ponta a ponta nem em transferência. Um proxy é obrigatório e a acessibilidade dele é verificada antes de o início ser aceito. O kernel do navegador precisa ser um que o navegador na nuvem suporte, o que exclui o Firefox. Os limites de abertura da equipe são aplicados e, em implantações com a cobrança do navegador na nuvem ativada, o saldo de créditos de IA também é verificado.
  • Uma execução por perfil: um membro pode ter apenas uma execução ativa por perfil. Quando a equipe ativa o bloqueio de segurança, a execução de outro membro bloqueia a sua.
  • Conclusão: aceito, não concluído. data está vazio; o runtime é provisionado de forma assíncrona. Consulte /cloudbrowser/page até que cloudBrowserStatus seja RUNNING e depois chame /cloudbrowser/connect para obter cdpUrl. Um início pode ser aceito e falhar depois, o que aparece nessa página.
  • Concorrência: inícios simultâneos de um perfil são serializados por um bloqueio; quem perde é rejeitado em vez de entrar na fila.
  • Nova tentativa: depois de um timeout, leia /cloudbrowser/page — não reenvie.

Erros de negócio documentados: 19039, 19065, 40001, 40003, 40015, 40016, 40021, 40023, 40024, 40025, 40026, 40027, 40028, 40029, 40037. 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/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
}