Navegador en la nube

Inicie, detenga, conecte y gestione entornos de navegador en la nube mediante programación a través de la API de MoreLogin.

Descripción general

La API de Navegador en la nube ejecuta un perfil de navegador de MoreLogin en un host remoto. Después de iniciar un entorno, puede conectarse a él mediante el protocolo Chrome DevTools (CDP) y controlarlo con marcos de automatización como Puppeteer, Playwright o Selenium.

El Navegador en la nube admite dos métodos de acceso a la API:

Método	Base URL	Caso de uso
API abierta (remota)	`https://api.morelogin.com`	Acceso desde cualquier lugar, autenticación OAuth2
API local (local)	`http://127.0.0.1:40000`	Acceso desde la máquina que ejecuta el cliente MoreLogin

Elija la API abierta si necesita acceso remoto o integración de servidor a servidor. Elija la API local si ejecuta la automatización en la misma máquina que el cliente MoreLogin.

Para obtener detalles sobre la autenticación, consulte Autenticación.

Capacidades

Operación	Descripción
Iniciar	Inicia un entorno de navegador en la nube
Detener	Detiene un entorno en ejecución, con la opción de forzar su liberación
Paginar	Consulta entornos por página con filtros de nombre, grupo y palabra clave
Conectar	Obtiene la dirección CDP de un entorno en ejecución para conectar herramientas de automatización

Flujo de trabajo típico

Inicie el entorno con envId. El entorno pasa al estado STARTING.
Consulte periódicamente la lista paginada hasta que cloudBrowserStatus sea RUNNING.
Conéctese para obtener el cdpUrl y, a continuación, conecte Puppeteer / Playwright / Selenium mediante CDP.
Detenga el entorno cuando finalice la automatización.

Estado del entorno

Estado	Descripción
`STARTING`	Iniciando
`RUNNING`	En ejecución
`CLOSED`	Cerrado

Detalles de conexión

El endpoint de conexión devuelve dos direcciones:

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

Campo	Descripción
`cdpUrl`	Endpoint CDP con el `token` de acceso. Pásela a Puppeteer, Playwright o Selenium.
`accessUrl`	Página de escritorio remoto en el navegador para ver y controlar la sesión. Vacío si no está configurado.

El token de accessUrl es una carga codificada en Base64 que contiene la URL del escritorio, el token del escritorio, la fecha de caducidad y los ID de equipo, usuario, miembro y entorno. Trate ambas URL como credenciales y no las comparta.

Referencia de la API

API	Descripción
API abierta de Navegador en la nube	Acceso remoto vía `https://api.morelogin.com`, autenticación OAuth2
API local de Navegador en la nube	Acceso local vía `http://127.0.0.1:40000`, autenticación por token

Nota: Ambas API exponen las mismas operaciones. Las rutas de la API local usan el prefijo /api/cloudbrowser/..., mientras que las de la API abierta usan /cloudbrowser/.... Consulte siempre la referencia específica de la API para conocer las rutas y parámetros exactos.

Guías relacionadas

Guía	Descripción
Autenticación	Configuración de token OAuth2 (API abierta) y autenticación por token (API local)
Inicio rápido	Ejecute su primera llamada a la API de MoreLogin