# 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](/es/api-reference/getting-started/authentication).

## 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

1. **Inicie** el entorno con `envId`. El entorno pasa al estado `STARTING`.
2. **Consulte periódicamente** la lista paginada hasta que `cloudBrowserStatus` sea `RUNNING`.
3. **Conéctese** para obtener el `cdpUrl` y, a continuación, conecte Puppeteer / Playwright / Selenium mediante CDP.
4. **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:

```json
{
  "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](/es/api-reference/cloud-browser/open-api) | Acceso remoto vía `https://api.morelogin.com`, autenticación OAuth2 |
| [API local de Navegador en la nube](/es/api-reference/cloud-browser/local-api) | 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](/es/api-reference/getting-started/authentication) | Configuración de token OAuth2 (API abierta) y autenticación por token (API local) |
| [Inicio rápido](/es/api-reference/getting-started/quickstart) | Ejecute su primera llamada a la API de MoreLogin |